xref: /llvm-project/flang/lib/Parser/executable-parsers.cpp (revision 561a3697099aa74fcbaf426e6d0ebeb783b57a1e)
1 //===-- lib/Parser/executable-parsers.cpp ---------------------------------===//
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 // Per-type parsers for executable statements
10 
11 #include "basic-parsers.h"
12 #include "debug-parser.h"
13 #include "expr-parsers.h"
14 #include "misc-parsers.h"
15 #include "stmt-parser.h"
16 #include "token-parsers.h"
17 #include "type-parser-implementation.h"
18 #include "flang/Parser/characters.h"
19 #include "flang/Parser/parse-tree.h"
20 
21 namespace Fortran::parser {
22 
23 // Fortran allows the statement with the corresponding label at the end of
24 // a do-construct that begins with an old-style label-do-stmt to be a
25 // new-style END DO statement; e.g., DO 10 I=1,N; ...; 10 END DO.  Usually,
26 // END DO statements appear only at the ends of do-constructs that begin
27 // with a nonlabel-do-stmt, so care must be taken to recognize this case and
28 // essentially treat them like CONTINUE statements.
29 
30 // R514 executable-construct ->
31 //        action-stmt | associate-construct | block-construct |
32 //        case-construct | change-team-construct | critical-construct |
33 //        do-construct | if-construct | select-rank-construct |
34 //        select-type-construct | where-construct | forall-construct |
35 // (CUDA) CUF-kernel-do-construct
36 constexpr auto executableConstruct{first(
37     construct<ExecutableConstruct>(CapturedLabelDoStmt{}),
38     construct<ExecutableConstruct>(EndDoStmtForCapturedLabelDoStmt{}),
39     construct<ExecutableConstruct>(indirect(Parser<DoConstruct>{})),
40     // Attempt DO statements before assignment statements for better
41     // error messages in cases like "DO10I=1,(error)".
42     construct<ExecutableConstruct>(statement(actionStmt)),
43     construct<ExecutableConstruct>(indirect(Parser<AssociateConstruct>{})),
44     construct<ExecutableConstruct>(indirect(Parser<BlockConstruct>{})),
45     construct<ExecutableConstruct>(indirect(Parser<CaseConstruct>{})),
46     construct<ExecutableConstruct>(indirect(Parser<ChangeTeamConstruct>{})),
47     construct<ExecutableConstruct>(indirect(Parser<CriticalConstruct>{})),
48     construct<ExecutableConstruct>(indirect(Parser<IfConstruct>{})),
49     construct<ExecutableConstruct>(indirect(Parser<SelectRankConstruct>{})),
50     construct<ExecutableConstruct>(indirect(Parser<SelectTypeConstruct>{})),
51     construct<ExecutableConstruct>(indirect(whereConstruct)),
52     construct<ExecutableConstruct>(indirect(forallConstruct)),
53     construct<ExecutableConstruct>(indirect(ompEndLoopDirective)),
54     construct<ExecutableConstruct>(indirect(openmpConstruct)),
55     construct<ExecutableConstruct>(indirect(Parser<OpenACCConstruct>{})),
56     construct<ExecutableConstruct>(indirect(compilerDirective)),
57     construct<ExecutableConstruct>(indirect(Parser<CUFKernelDoConstruct>{})))};
58 
59 // R510 execution-part-construct ->
60 //        executable-construct | format-stmt | entry-stmt | data-stmt
61 // Extension (PGI/Intel): also accept NAMELIST in execution part
62 constexpr auto obsoleteExecutionPartConstruct{recovery(ignoredStatementPrefix >>
63         fail<ExecutionPartConstruct>(
64             "obsolete legacy extension is not supported"_err_en_US),
65     construct<ExecutionPartConstruct>(construct<ErrorRecovery>(ok /
66         statement("REDIMENSION" >> name /
67                 parenthesized(nonemptyList(Parser<AllocateShapeSpec>{}))))))};
68 
69 TYPE_PARSER(recovery(
70     withMessage("expected execution part construct"_err_en_US,
71         CONTEXT_PARSER("execution part construct"_en_US,
72             first(construct<ExecutionPartConstruct>(executableConstruct),
73                 construct<ExecutionPartConstruct>(
74                     statement(indirect(formatStmt))),
75                 construct<ExecutionPartConstruct>(
76                     statement(indirect(entryStmt))),
77                 construct<ExecutionPartConstruct>(
78                     statement(indirect(dataStmt))),
79                 extension<LanguageFeature::ExecutionPartNamelist>(
80                     "nonstandard usage: NAMELIST in execution part"_port_en_US,
81                     construct<ExecutionPartConstruct>(
82                         statement(indirect(Parser<NamelistStmt>{})))),
83                 obsoleteExecutionPartConstruct))),
84     construct<ExecutionPartConstruct>(executionPartErrorRecovery)))
85 
86 // R509 execution-part -> executable-construct [execution-part-construct]...
87 TYPE_CONTEXT_PARSER("execution part"_en_US,
88     construct<ExecutionPart>(many(executionPartConstruct)))
89 
90 // R515 action-stmt ->
91 //        allocate-stmt | assignment-stmt | backspace-stmt | call-stmt |
92 //        close-stmt | continue-stmt | cycle-stmt | deallocate-stmt |
93 //        endfile-stmt | error-stop-stmt | event-post-stmt | event-wait-stmt |
94 //        exit-stmt | fail-image-stmt | flush-stmt | form-team-stmt |
95 //        goto-stmt | if-stmt | inquire-stmt | lock-stmt | nullify-stmt |
96 //        open-stmt | pointer-assignment-stmt | print-stmt | read-stmt |
97 //        return-stmt | rewind-stmt | stop-stmt | sync-all-stmt |
98 //        sync-images-stmt | sync-memory-stmt | sync-team-stmt | unlock-stmt |
99 //        wait-stmt | where-stmt | write-stmt | computed-goto-stmt | forall-stmt
100 // R1159 continue-stmt -> CONTINUE
101 // R1163 fail-image-stmt -> FAIL IMAGE
102 TYPE_PARSER(first(construct<ActionStmt>(indirect(Parser<AllocateStmt>{})),
103     construct<ActionStmt>(indirect(assignmentStmt)),
104     construct<ActionStmt>(indirect(pointerAssignmentStmt)),
105     construct<ActionStmt>(indirect(Parser<BackspaceStmt>{})),
106     construct<ActionStmt>(indirect(Parser<CallStmt>{})),
107     construct<ActionStmt>(indirect(Parser<CloseStmt>{})),
108     construct<ActionStmt>(construct<ContinueStmt>("CONTINUE"_tok)),
109     construct<ActionStmt>(indirect(Parser<CycleStmt>{})),
110     construct<ActionStmt>(indirect(Parser<DeallocateStmt>{})),
111     construct<ActionStmt>(indirect(Parser<EndfileStmt>{})),
112     construct<ActionStmt>(indirect(Parser<EventPostStmt>{})),
113     construct<ActionStmt>(indirect(Parser<EventWaitStmt>{})),
114     construct<ActionStmt>(indirect(Parser<ExitStmt>{})),
115     construct<ActionStmt>(construct<FailImageStmt>("FAIL IMAGE"_sptok)),
116     construct<ActionStmt>(indirect(Parser<FlushStmt>{})),
117     construct<ActionStmt>(indirect(Parser<FormTeamStmt>{})),
118     construct<ActionStmt>(indirect(Parser<GotoStmt>{})),
119     construct<ActionStmt>(indirect(Parser<IfStmt>{})),
120     construct<ActionStmt>(indirect(Parser<InquireStmt>{})),
121     construct<ActionStmt>(indirect(Parser<LockStmt>{})),
122     construct<ActionStmt>(indirect(Parser<NullifyStmt>{})),
123     construct<ActionStmt>(indirect(Parser<OpenStmt>{})),
124     construct<ActionStmt>(indirect(Parser<PrintStmt>{})),
125     construct<ActionStmt>(indirect(Parser<ReadStmt>{})),
126     construct<ActionStmt>(indirect(Parser<ReturnStmt>{})),
127     construct<ActionStmt>(indirect(Parser<RewindStmt>{})),
128     construct<ActionStmt>(indirect(Parser<StopStmt>{})), // & error-stop-stmt
129     construct<ActionStmt>(indirect(Parser<SyncAllStmt>{})),
130     construct<ActionStmt>(indirect(Parser<SyncImagesStmt>{})),
131     construct<ActionStmt>(indirect(Parser<SyncMemoryStmt>{})),
132     construct<ActionStmt>(indirect(Parser<SyncTeamStmt>{})),
133     construct<ActionStmt>(indirect(Parser<UnlockStmt>{})),
134     construct<ActionStmt>(indirect(Parser<WaitStmt>{})),
135     construct<ActionStmt>(indirect(whereStmt)),
136     construct<ActionStmt>(indirect(Parser<WriteStmt>{})),
137     construct<ActionStmt>(indirect(Parser<ComputedGotoStmt>{})),
138     construct<ActionStmt>(indirect(forallStmt)),
139     construct<ActionStmt>(indirect(Parser<ArithmeticIfStmt>{})),
140     construct<ActionStmt>(indirect(Parser<AssignStmt>{})),
141     construct<ActionStmt>(indirect(Parser<AssignedGotoStmt>{})),
142     construct<ActionStmt>(indirect(Parser<PauseStmt>{}))))
143 
144 // R1102 associate-construct -> associate-stmt block end-associate-stmt
145 TYPE_CONTEXT_PARSER("ASSOCIATE construct"_en_US,
146     construct<AssociateConstruct>(statement(Parser<AssociateStmt>{}), block,
147         statement(Parser<EndAssociateStmt>{})))
148 
149 // R1103 associate-stmt ->
150 //        [associate-construct-name :] ASSOCIATE ( association-list )
151 TYPE_CONTEXT_PARSER("ASSOCIATE statement"_en_US,
152     construct<AssociateStmt>(maybe(name / ":"),
153         "ASSOCIATE" >> parenthesized(nonemptyList(Parser<Association>{}))))
154 
155 // R1104 association -> associate-name => selector
156 TYPE_PARSER(construct<Association>(name, "=>" >> selector))
157 
158 // R1105 selector -> expr | variable
159 TYPE_PARSER(construct<Selector>(variable) / lookAhead(","_tok || ")"_tok) ||
160     construct<Selector>(expr))
161 
162 // R1106 end-associate-stmt -> END ASSOCIATE [associate-construct-name]
163 TYPE_PARSER(construct<EndAssociateStmt>(recovery(
164     "END ASSOCIATE" >> maybe(name), namedConstructEndStmtErrorRecovery)))
165 
166 // R1107 block-construct ->
167 //         block-stmt [block-specification-part] block end-block-stmt
168 TYPE_CONTEXT_PARSER("BLOCK construct"_en_US,
169     construct<BlockConstruct>(statement(Parser<BlockStmt>{}),
170         Parser<BlockSpecificationPart>{}, // can be empty
171         block, statement(Parser<EndBlockStmt>{})))
172 
173 // R1108 block-stmt -> [block-construct-name :] BLOCK
174 TYPE_PARSER(construct<BlockStmt>(maybe(name / ":") / "BLOCK"))
175 
176 // R1109 block-specification-part ->
177 //         [use-stmt]... [import-stmt]... [implicit-part]
178 //         [[declaration-construct]... specification-construct]
179 // C1107 prohibits COMMON, EQUIVALENCE, INTENT, NAMELIST, OPTIONAL, VALUE,
180 // and statement function definitions.  C1108 prohibits SAVE /common/.
181 // C1570 indirectly prohibits ENTRY.  These constraints are best enforced later.
182 // The odd grammar rule above would have the effect of forcing any
183 // trailing FORMAT and DATA statements after the last specification-construct
184 // to be recognized as part of the block-construct's block part rather than
185 // its block-specification-part, a distinction without any apparent difference.
186 TYPE_PARSER(construct<BlockSpecificationPart>(specificationPart))
187 
188 // R1110 end-block-stmt -> END BLOCK [block-construct-name]
189 TYPE_PARSER(construct<EndBlockStmt>(
190     recovery("END BLOCK" >> maybe(name), namedConstructEndStmtErrorRecovery)))
191 
192 // R1111 change-team-construct -> change-team-stmt block end-change-team-stmt
193 TYPE_CONTEXT_PARSER("CHANGE TEAM construct"_en_US,
194     construct<ChangeTeamConstruct>(statement(Parser<ChangeTeamStmt>{}), block,
195         statement(Parser<EndChangeTeamStmt>{})))
196 
197 // R1112 change-team-stmt ->
198 //         [team-construct-name :] CHANGE TEAM
199 //         ( team-value [, coarray-association-list] [, sync-stat-list] )
200 TYPE_CONTEXT_PARSER("CHANGE TEAM statement"_en_US,
201     construct<ChangeTeamStmt>(maybe(name / ":"),
202         "CHANGE TEAM"_sptok >> "("_tok >> teamValue,
203         defaulted("," >> nonemptyList(Parser<CoarrayAssociation>{})),
204         defaulted("," >> nonemptyList(statOrErrmsg))) /
205         ")")
206 
207 // R1113 coarray-association -> codimension-decl => selector
208 TYPE_PARSER(
209     construct<CoarrayAssociation>(Parser<CodimensionDecl>{}, "=>" >> selector))
210 
211 // R1114 end-change-team-stmt ->
212 //         END TEAM [( [sync-stat-list] )] [team-construct-name]
213 TYPE_CONTEXT_PARSER("END TEAM statement"_en_US,
214     construct<EndChangeTeamStmt>(
215         "END TEAM" >> defaulted(parenthesized(optionalList(statOrErrmsg))),
216         maybe(name)))
217 
218 // R1117 critical-stmt ->
219 //         [critical-construct-name :] CRITICAL [( [sync-stat-list] )]
220 TYPE_CONTEXT_PARSER("CRITICAL statement"_en_US,
221     construct<CriticalStmt>(maybe(name / ":"),
222         "CRITICAL" >> defaulted(parenthesized(optionalList(statOrErrmsg)))))
223 
224 // R1116 critical-construct -> critical-stmt block end-critical-stmt
225 TYPE_CONTEXT_PARSER("CRITICAL construct"_en_US,
226     construct<CriticalConstruct>(statement(Parser<CriticalStmt>{}), block,
227         statement(Parser<EndCriticalStmt>{})))
228 
229 // R1118 end-critical-stmt -> END CRITICAL [critical-construct-name]
230 TYPE_PARSER(construct<EndCriticalStmt>(recovery(
231     "END CRITICAL" >> maybe(name), namedConstructEndStmtErrorRecovery)))
232 
233 // R1119 do-construct -> do-stmt block end-do
234 // R1120 do-stmt -> nonlabel-do-stmt | label-do-stmt
235 TYPE_CONTEXT_PARSER("DO construct"_en_US,
236     construct<DoConstruct>(
237         statement(Parser<NonLabelDoStmt>{}) / EnterNonlabelDoConstruct{}, block,
238         statement(Parser<EndDoStmt>{}) / LeaveDoConstruct{}))
239 
240 // R1125 concurrent-header ->
241 //         ( [integer-type-spec ::] concurrent-control-list
242 //         [, scalar-mask-expr] )
243 TYPE_PARSER(parenthesized(construct<ConcurrentHeader>(
244     maybe(integerTypeSpec / "::"), nonemptyList(Parser<ConcurrentControl>{}),
245     maybe("," >> scalarLogicalExpr))))
246 
247 // R1126 concurrent-control ->
248 //         index-name = concurrent-limit : concurrent-limit [: concurrent-step]
249 // R1127 concurrent-limit -> scalar-int-expr
250 // R1128 concurrent-step -> scalar-int-expr
251 TYPE_PARSER(construct<ConcurrentControl>(name / "=", scalarIntExpr / ":",
252     scalarIntExpr, maybe(":" >> scalarIntExpr)))
253 
254 // R1130 locality-spec ->
255 //         LOCAL ( variable-name-list ) | LOCAL_INIT ( variable-name-list ) |
256 //         SHARED ( variable-name-list ) | DEFAULT ( NONE )
257 TYPE_PARSER(construct<LocalitySpec>(construct<LocalitySpec::Local>(
258                 "LOCAL" >> parenthesized(listOfNames))) ||
259     construct<LocalitySpec>(construct<LocalitySpec::LocalInit>(
260         "LOCAL_INIT"_sptok >> parenthesized(listOfNames))) ||
261     construct<LocalitySpec>(construct<LocalitySpec::Shared>(
262         "SHARED" >> parenthesized(listOfNames))) ||
263     construct<LocalitySpec>(
264         construct<LocalitySpec::DefaultNone>("DEFAULT ( NONE )"_tok)))
265 
266 // R1123 loop-control ->
267 //         [,] do-variable = scalar-int-expr , scalar-int-expr
268 //           [, scalar-int-expr] |
269 //         [,] WHILE ( scalar-logical-expr ) |
270 //         [,] CONCURRENT concurrent-header concurrent-locality
271 // R1129 concurrent-locality -> [locality-spec]...
272 TYPE_CONTEXT_PARSER("loop control"_en_US,
273     maybe(","_tok) >>
274         (construct<LoopControl>(loopBounds(scalarExpr)) ||
275             construct<LoopControl>(
276                 "WHILE" >> parenthesized(scalarLogicalExpr)) ||
277             construct<LoopControl>(construct<LoopControl::Concurrent>(
278                 "CONCURRENT" >> concurrentHeader,
279                 many(Parser<LocalitySpec>{})))))
280 
281 // R1121 label-do-stmt -> [do-construct-name :] DO label [loop-control]
282 TYPE_CONTEXT_PARSER("label DO statement"_en_US,
283     construct<LabelDoStmt>(
284         maybe(name / ":"), "DO" >> label, maybe(loopControl)))
285 
286 // R1122 nonlabel-do-stmt -> [do-construct-name :] DO [loop-control]
287 TYPE_CONTEXT_PARSER("nonlabel DO statement"_en_US,
288     construct<NonLabelDoStmt>(maybe(name / ":"), "DO" >> maybe(loopControl)))
289 
290 // R1132 end-do-stmt -> END DO [do-construct-name]
291 TYPE_CONTEXT_PARSER("END DO statement"_en_US,
292     construct<EndDoStmt>(
293         recovery("END DO" >> maybe(name), namedConstructEndStmtErrorRecovery)))
294 
295 // R1133 cycle-stmt -> CYCLE [do-construct-name]
296 TYPE_CONTEXT_PARSER(
297     "CYCLE statement"_en_US, construct<CycleStmt>("CYCLE" >> maybe(name)))
298 
299 // R1134 if-construct ->
300 //         if-then-stmt block [else-if-stmt block]...
301 //         [else-stmt block] end-if-stmt
302 // R1135 if-then-stmt -> [if-construct-name :] IF ( scalar-logical-expr )
303 // THEN R1136 else-if-stmt ->
304 //         ELSE IF ( scalar-logical-expr ) THEN [if-construct-name]
305 // R1137 else-stmt -> ELSE [if-construct-name]
306 // R1138 end-if-stmt -> END IF [if-construct-name]
307 TYPE_CONTEXT_PARSER("IF construct"_en_US,
308     construct<IfConstruct>(
309         statement(construct<IfThenStmt>(maybe(name / ":"),
310             "IF" >> parenthesized(scalarLogicalExpr) /
311                     recovery("THEN"_tok, lookAhead(endOfStmt)))),
312         block,
313         many(construct<IfConstruct::ElseIfBlock>(
314             unambiguousStatement(construct<ElseIfStmt>(
315                 "ELSE IF" >> parenthesized(scalarLogicalExpr),
316                 recovery("THEN"_tok, ok) >> maybe(name))),
317             block)),
318         maybe(construct<IfConstruct::ElseBlock>(
319             statement(construct<ElseStmt>("ELSE" >> maybe(name))), block)),
320         statement(construct<EndIfStmt>(recovery(
321             "END IF" >> maybe(name), namedConstructEndStmtErrorRecovery)))))
322 
323 // R1139 if-stmt -> IF ( scalar-logical-expr ) action-stmt
324 TYPE_CONTEXT_PARSER("IF statement"_en_US,
325     construct<IfStmt>("IF" >> parenthesized(scalarLogicalExpr),
326         unlabeledStatement(actionStmt)))
327 
328 // R1140 case-construct ->
329 //         select-case-stmt [case-stmt block]... end-select-stmt
330 TYPE_CONTEXT_PARSER("SELECT CASE construct"_en_US,
331     construct<CaseConstruct>(statement(Parser<SelectCaseStmt>{}),
332         many(construct<CaseConstruct::Case>(
333             unambiguousStatement(Parser<CaseStmt>{}), block)),
334         statement(endSelectStmt)))
335 
336 // R1141 select-case-stmt -> [case-construct-name :] SELECT CASE ( case-expr
337 // ) R1144 case-expr -> scalar-expr
338 TYPE_CONTEXT_PARSER("SELECT CASE statement"_en_US,
339     construct<SelectCaseStmt>(
340         maybe(name / ":"), "SELECT CASE" >> parenthesized(scalar(expr))))
341 
342 // R1142 case-stmt -> CASE case-selector [case-construct-name]
343 TYPE_CONTEXT_PARSER("CASE statement"_en_US,
344     construct<CaseStmt>("CASE" >> Parser<CaseSelector>{}, maybe(name)))
345 
346 // R1143 end-select-stmt -> END SELECT [case-construct-name]
347 // R1151 end-select-rank-stmt -> END SELECT [select-construct-name]
348 // R1155 end-select-type-stmt -> END SELECT [select-construct-name]
349 TYPE_PARSER(construct<EndSelectStmt>(
350     recovery("END SELECT" >> maybe(name), namedConstructEndStmtErrorRecovery)))
351 
352 // R1145 case-selector -> ( case-value-range-list ) | DEFAULT
353 constexpr auto defaultKeyword{construct<Default>("DEFAULT"_tok)};
354 TYPE_PARSER(parenthesized(construct<CaseSelector>(
355                 nonemptyList(Parser<CaseValueRange>{}))) ||
356     construct<CaseSelector>(defaultKeyword))
357 
358 // R1147 case-value -> scalar-constant-expr
359 constexpr auto caseValue{scalar(constantExpr)};
360 
361 // R1146 case-value-range ->
362 //         case-value | case-value : | : case-value | case-value : case-value
363 TYPE_PARSER(construct<CaseValueRange>(construct<CaseValueRange::Range>(
364                 construct<std::optional<CaseValue>>(caseValue),
365                 ":" >> maybe(caseValue))) ||
366     construct<CaseValueRange>(
367         construct<CaseValueRange::Range>(construct<std::optional<CaseValue>>(),
368             ":" >> construct<std::optional<CaseValue>>(caseValue))) ||
369     construct<CaseValueRange>(caseValue))
370 
371 // R1148 select-rank-construct ->
372 //         select-rank-stmt [select-rank-case-stmt block]...
373 //         end-select-rank-stmt
374 TYPE_CONTEXT_PARSER("SELECT RANK construct"_en_US,
375     construct<SelectRankConstruct>(statement(Parser<SelectRankStmt>{}),
376         many(construct<SelectRankConstruct::RankCase>(
377             unambiguousStatement(Parser<SelectRankCaseStmt>{}), block)),
378         statement(endSelectStmt)))
379 
380 // R1149 select-rank-stmt ->
381 //         [select-construct-name :] SELECT RANK
382 //         ( [associate-name =>] selector )
383 TYPE_CONTEXT_PARSER("SELECT RANK statement"_en_US,
384     construct<SelectRankStmt>(maybe(name / ":"),
385         "SELECT RANK"_sptok >> "("_tok >> maybe(name / "=>"), selector / ")"))
386 
387 // R1150 select-rank-case-stmt ->
388 //         RANK ( scalar-int-constant-expr ) [select-construct-name] |
389 //         RANK ( * ) [select-construct-name] |
390 //         RANK DEFAULT [select-construct-name]
391 TYPE_CONTEXT_PARSER("RANK case statement"_en_US,
392     "RANK" >> (construct<SelectRankCaseStmt>(
393                   parenthesized(construct<SelectRankCaseStmt::Rank>(
394                                     scalarIntConstantExpr) ||
395                       construct<SelectRankCaseStmt::Rank>(star)) ||
396                       construct<SelectRankCaseStmt::Rank>(defaultKeyword),
397                   maybe(name))))
398 
399 // R1152 select-type-construct ->
400 //         select-type-stmt [type-guard-stmt block]... end-select-type-stmt
401 TYPE_CONTEXT_PARSER("SELECT TYPE construct"_en_US,
402     construct<SelectTypeConstruct>(statement(Parser<SelectTypeStmt>{}),
403         many(construct<SelectTypeConstruct::TypeCase>(
404             unambiguousStatement(Parser<TypeGuardStmt>{}), block)),
405         statement(endSelectStmt)))
406 
407 // R1153 select-type-stmt ->
408 //         [select-construct-name :] SELECT TYPE
409 //         ( [associate-name =>] selector )
410 TYPE_CONTEXT_PARSER("SELECT TYPE statement"_en_US,
411     construct<SelectTypeStmt>(maybe(name / ":"),
412         "SELECT TYPE (" >> maybe(name / "=>"), selector / ")"))
413 
414 // R1154 type-guard-stmt ->
415 //         TYPE IS ( type-spec ) [select-construct-name] |
416 //         CLASS IS ( derived-type-spec ) [select-construct-name] |
417 //         CLASS DEFAULT [select-construct-name]
418 TYPE_CONTEXT_PARSER("type guard statement"_en_US,
419     construct<TypeGuardStmt>("TYPE IS"_sptok >>
420                 parenthesized(construct<TypeGuardStmt::Guard>(typeSpec)) ||
421             "CLASS IS"_sptok >> parenthesized(construct<TypeGuardStmt::Guard>(
422                                     derivedTypeSpec)) ||
423             construct<TypeGuardStmt::Guard>("CLASS" >> defaultKeyword),
424         maybe(name)))
425 
426 // R1156 exit-stmt -> EXIT [construct-name]
427 TYPE_CONTEXT_PARSER(
428     "EXIT statement"_en_US, construct<ExitStmt>("EXIT" >> maybe(name)))
429 
430 // R1157 goto-stmt -> GO TO label
431 TYPE_CONTEXT_PARSER(
432     "GOTO statement"_en_US, construct<GotoStmt>("GO TO" >> label))
433 
434 // R1158 computed-goto-stmt -> GO TO ( label-list ) [,] scalar-int-expr
435 TYPE_CONTEXT_PARSER("computed GOTO statement"_en_US,
436     construct<ComputedGotoStmt>("GO TO" >> parenthesized(nonemptyList(label)),
437         maybe(","_tok) >> scalarIntExpr))
438 
439 // R1160 stop-stmt -> STOP [stop-code] [, QUIET = scalar-logical-expr]
440 // R1161 error-stop-stmt ->
441 //         ERROR STOP [stop-code] [, QUIET = scalar-logical-expr]
442 TYPE_CONTEXT_PARSER("STOP statement"_en_US,
443     construct<StopStmt>("STOP" >> pure(StopStmt::Kind::Stop) ||
444             "ERROR STOP"_sptok >> pure(StopStmt::Kind::ErrorStop),
445         maybe(Parser<StopCode>{}), maybe(", QUIET =" >> scalarLogicalExpr)))
446 
447 // R1162 stop-code -> scalar-default-char-expr | scalar-int-expr
448 // The two alternatives for stop-code can't be distinguished at
449 // parse time.
450 TYPE_PARSER(construct<StopCode>(scalar(expr)))
451 
452 // R1164 sync-all-stmt -> SYNC ALL [( [sync-stat-list] )]
453 TYPE_CONTEXT_PARSER("SYNC ALL statement"_en_US,
454     construct<SyncAllStmt>("SYNC ALL"_sptok >>
455         defaulted(parenthesized(optionalList(statOrErrmsg)))))
456 
457 // R1166 sync-images-stmt -> SYNC IMAGES ( image-set [, sync-stat-list] )
458 // R1167 image-set -> int-expr | *
459 TYPE_CONTEXT_PARSER("SYNC IMAGES statement"_en_US,
460     "SYNC IMAGES"_sptok >> parenthesized(construct<SyncImagesStmt>(
461                                construct<SyncImagesStmt::ImageSet>(intExpr) ||
462                                    construct<SyncImagesStmt::ImageSet>(star),
463                                defaulted("," >> nonemptyList(statOrErrmsg)))))
464 
465 // R1168 sync-memory-stmt -> SYNC MEMORY [( [sync-stat-list] )]
466 TYPE_CONTEXT_PARSER("SYNC MEMORY statement"_en_US,
467     construct<SyncMemoryStmt>("SYNC MEMORY"_sptok >>
468         defaulted(parenthesized(optionalList(statOrErrmsg)))))
469 
470 // R1169 sync-team-stmt -> SYNC TEAM ( team-value [, sync-stat-list] )
471 TYPE_CONTEXT_PARSER("SYNC TEAM statement"_en_US,
472     construct<SyncTeamStmt>("SYNC TEAM"_sptok >> "("_tok >> teamValue,
473         defaulted("," >> nonemptyList(statOrErrmsg)) / ")"))
474 
475 // R1170 event-post-stmt -> EVENT POST ( event-variable [, sync-stat-list] )
476 // R1171 event-variable -> scalar-variable
477 TYPE_CONTEXT_PARSER("EVENT POST statement"_en_US,
478     construct<EventPostStmt>("EVENT POST"_sptok >> "("_tok >> scalar(variable),
479         defaulted("," >> nonemptyList(statOrErrmsg)) / ")"))
480 
481 // R1172 event-wait-stmt ->
482 //         EVENT WAIT ( event-variable [, event-wait-spec-list] )
483 TYPE_CONTEXT_PARSER("EVENT WAIT statement"_en_US,
484     construct<EventWaitStmt>("EVENT WAIT"_sptok >> "("_tok >> scalar(variable),
485         defaulted("," >> nonemptyList(Parser<EventWaitStmt::EventWaitSpec>{})) /
486             ")"))
487 
488 // R1174 until-spec -> UNTIL_COUNT = scalar-int-expr
489 constexpr auto untilSpec{"UNTIL_COUNT =" >> scalarIntExpr};
490 
491 // R1173 event-wait-spec -> until-spec | sync-stat
492 TYPE_PARSER(construct<EventWaitStmt::EventWaitSpec>(untilSpec) ||
493     construct<EventWaitStmt::EventWaitSpec>(statOrErrmsg))
494 
495 // R1177 team-variable -> scalar-variable
496 constexpr auto teamVariable{scalar(variable)};
497 
498 // R1175 form-team-stmt ->
499 //         FORM TEAM ( team-number , team-variable [, form-team-spec-list] )
500 // R1176 team-number -> scalar-int-expr
501 TYPE_CONTEXT_PARSER("FORM TEAM statement"_en_US,
502     construct<FormTeamStmt>("FORM TEAM"_sptok >> "("_tok >> scalarIntExpr,
503         "," >> teamVariable,
504         defaulted("," >> nonemptyList(Parser<FormTeamStmt::FormTeamSpec>{})) /
505             ")"))
506 
507 // R1178 form-team-spec -> NEW_INDEX = scalar-int-expr | sync-stat
508 TYPE_PARSER(
509     construct<FormTeamStmt::FormTeamSpec>("NEW_INDEX =" >> scalarIntExpr) ||
510     construct<FormTeamStmt::FormTeamSpec>(statOrErrmsg))
511 
512 // R1182 lock-variable -> scalar-variable
513 constexpr auto lockVariable{scalar(variable)};
514 
515 // R1179 lock-stmt -> LOCK ( lock-variable [, lock-stat-list] )
516 TYPE_CONTEXT_PARSER("LOCK statement"_en_US,
517     construct<LockStmt>("LOCK (" >> lockVariable,
518         defaulted("," >> nonemptyList(Parser<LockStmt::LockStat>{})) / ")"))
519 
520 // R1180 lock-stat -> ACQUIRED_LOCK = scalar-logical-variable | sync-stat
521 TYPE_PARSER(
522     construct<LockStmt::LockStat>("ACQUIRED_LOCK =" >> scalarLogicalVariable) ||
523     construct<LockStmt::LockStat>(statOrErrmsg))
524 
525 // R1181 unlock-stmt -> UNLOCK ( lock-variable [, sync-stat-list] )
526 TYPE_CONTEXT_PARSER("UNLOCK statement"_en_US,
527     construct<UnlockStmt>("UNLOCK (" >> lockVariable,
528         defaulted("," >> nonemptyList(statOrErrmsg)) / ")"))
529 
530 // CUF-kernel-do-construct -> CUF-kernel-do-directive do-construct
531 // CUF-kernel-do-directive ->
532 //     !$CUF KERNEL DO [ (scalar-int-constant-expr) ] <<< grid, block [, stream]
533 //     >>> do-construct
534 // grid -> * | scalar-int-expr | ( scalar-int-expr-list )
535 // block -> * | scalar-int-expr | ( scalar-int-expr-list )
536 // stream -> ( 0, | STREAM = ) scalar-int-expr
537 TYPE_PARSER(sourced(beginDirective >> "$CUF KERNEL DO"_tok >>
538     construct<CUFKernelDoConstruct::Directive>(
539         maybe(parenthesized(scalarIntConstantExpr)),
540         "<<<" >>
541             ("*" >> pure<std::list<ScalarIntExpr>>() ||
542                 parenthesized(nonemptyList(scalarIntExpr)) ||
543                 applyFunction(singletonList<ScalarIntExpr>, scalarIntExpr)),
544         "," >> ("*" >> pure<std::list<ScalarIntExpr>>() ||
545                    parenthesized(nonemptyList(scalarIntExpr)) ||
546                    applyFunction(singletonList<ScalarIntExpr>, scalarIntExpr)),
547         maybe((", 0 ,"_tok || ", STREAM ="_tok) >> scalarIntExpr) / ">>>" /
548             endDirective)))
549 TYPE_CONTEXT_PARSER("!$CUF KERNEL DO construct"_en_US,
550     extension<LanguageFeature::CUDA>(construct<CUFKernelDoConstruct>(
551         Parser<CUFKernelDoConstruct::Directive>{},
552         maybe(Parser<DoConstruct>{}))))
553 
554 } // namespace Fortran::parser
555