OSDN Git Service

2010-10-22 Thomas Quinot <quinot@adacore.com>
[pf3gnuchains/gcc-fork.git] / gcc / ada / par-ch5.adb
1 ------------------------------------------------------------------------------
2 --                                                                          --
3 --                         GNAT COMPILER COMPONENTS                         --
4 --                                                                          --
5 --                              P A R . C H 5                               --
6 --                                                                          --
7 --                                 B o d y                                  --
8 --                                                                          --
9 --          Copyright (C) 1992-2010, Free Software Foundation, Inc.         --
10 --                                                                          --
11 -- GNAT is free software;  you can  redistribute it  and/or modify it under --
12 -- terms of the  GNU General Public License as published  by the Free Soft- --
13 -- ware  Foundation;  either version 3,  or (at your option) any later ver- --
14 -- sion.  GNAT is distributed in the hope that it will be useful, but WITH- --
15 -- OUT ANY WARRANTY;  without even the  implied warranty of MERCHANTABILITY --
16 -- or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License --
17 -- for  more details.  You should have  received  a copy of the GNU General --
18 -- Public License  distributed with GNAT; see file COPYING3.  If not, go to --
19 -- http://www.gnu.org/licenses for a complete copy of the license.          --
20 --                                                                          --
21 -- GNAT was originally developed  by the GNAT team at  New York University. --
22 -- Extensive contributions were provided by Ada Core Technologies Inc.      --
23 --                                                                          --
24 ------------------------------------------------------------------------------
25
26 pragma Style_Checks (All_Checks);
27 --  Turn off subprogram body ordering check. Subprograms are in order
28 --  by RM section rather than alphabetical
29
30 separate (Par)
31 package body Ch5 is
32
33    --  Local functions, used only in this chapter
34
35    function P_Case_Statement                     return Node_Id;
36    function P_Case_Statement_Alternative         return Node_Id;
37    function P_Exit_Statement                     return Node_Id;
38    function P_Goto_Statement                     return Node_Id;
39    function P_If_Statement                       return Node_Id;
40    function P_Label                              return Node_Id;
41    function P_Null_Statement                     return Node_Id;
42
43    function P_Assignment_Statement (LHS : Node_Id)  return Node_Id;
44    --  Parse assignment statement. On entry, the caller has scanned the left
45    --  hand side (passed in as Lhs), and the colon-equal (or some symbol
46    --  taken to be an error equivalent such as equal).
47
48    function P_Begin_Statement (Block_Name : Node_Id := Empty) return Node_Id;
49    --  Parse begin-end statement. If Block_Name is non-Empty on entry, it is
50    --  the N_Identifier node for the label on the block. If Block_Name is
51    --  Empty on entry (the default), then the block statement is unlabeled.
52
53    function P_Declare_Statement (Block_Name : Node_Id := Empty) return Node_Id;
54    --  Parse declare block. If Block_Name is non-Empty on entry, it is
55    --  the N_Identifier node for the label on the block. If Block_Name is
56    --  Empty on entry (the default), then the block statement is unlabeled.
57
58    function P_For_Statement (Loop_Name : Node_Id := Empty) return Node_Id;
59    --  Parse for statement. If Loop_Name is non-Empty on entry, it is
60    --  the N_Identifier node for the label on the loop. If Loop_Name is
61    --  Empty on entry (the default), then the for statement is unlabeled.
62
63    function P_Iterator_Specification (Def_Id : Node_Id) return Node_Id;
64    --  Parse an iterator specification. The defining identifier has already
65    --  been scanned, as it is the common prefix between loop and iterator
66    --  specification.
67
68    function P_Loop_Statement (Loop_Name : Node_Id := Empty) return Node_Id;
69    --  Parse loop statement. If Loop_Name is non-Empty on entry, it is
70    --  the N_Identifier node for the label on the loop. If Loop_Name is
71    --  Empty on entry (the default), then the loop statement is unlabeled.
72
73    function P_While_Statement (Loop_Name : Node_Id := Empty) return Node_Id;
74    --  Parse while statement. If Loop_Name is non-Empty on entry, it is
75    --  the N_Identifier node for the label on the loop. If Loop_Name is
76    --  Empty on entry (the default), then the while statement is unlabeled.
77
78    function Set_Loop_Block_Name (L : Character) return Name_Id;
79    --  Given a letter 'L' for a loop or 'B' for a block, returns a name
80    --  of the form L_nn or B_nn where nn is a serial number obtained by
81    --  incrementing the variable Loop_Block_Count.
82
83    procedure Then_Scan;
84    --  Scan past THEN token, testing for illegal junk after it
85
86    ---------------------------------
87    -- 5.1  Sequence of Statements --
88    ---------------------------------
89
90    --  SEQUENCE_OF_STATEMENTS ::= STATEMENT {STATEMENT} {LABEL}
91    --  Note: the final label is an Ada 2012 addition.
92
93    --  STATEMENT ::=
94    --    {LABEL} SIMPLE_STATEMENT | {LABEL} COMPOUND_STATEMENT
95
96    --  SIMPLE_STATEMENT ::=      NULL_STATEMENT
97    --  | ASSIGNMENT_STATEMENT  | EXIT_STATEMENT
98    --  | GOTO_STATEMENT        | PROCEDURE_CALL_STATEMENT
99    --  | RETURN_STATEMENT      | ENTRY_CALL_STATEMENT
100    --  | REQUEUE_STATEMENT     | DELAY_STATEMENT
101    --  | ABORT_STATEMENT       | RAISE_STATEMENT
102    --  | CODE_STATEMENT
103
104    --  COMPOUND_STATEMENT ::=
105    --    IF_STATEMENT         | CASE_STATEMENT
106    --  | LOOP_STATEMENT       | BLOCK_STATEMENT
107    --  | ACCEPT_STATEMENT     | SELECT_STATEMENT
108
109    --  This procedure scans a sequence of statements. The caller sets SS_Flags
110    --  to indicate acceptable termination conditions for the sequence:
111
112    --    SS_Flags.Eftm Terminate on ELSIF
113    --    SS_Flags.Eltm Terminate on ELSE
114    --    SS_Flags.Extm Terminate on EXCEPTION
115    --    SS_Flags.Ortm Terminate on OR
116    --    SS_Flags.Tatm Terminate on THEN ABORT (Token = ABORT on return)
117    --    SS_Flags.Whtm Terminate on WHEN
118    --    SS_Flags.Unco Unconditional terminate after scanning one statement
119
120    --  In addition, the scan is always terminated by encountering END or the
121    --  end of file (EOF) condition. If one of the six above terminators is
122    --  encountered with the corresponding SS_Flags flag not set, then the
123    --  action taken is as follows:
124
125    --    If the keyword occurs to the left of the expected column of the end
126    --    for the current sequence (as recorded in the current end context),
127    --    then it is assumed to belong to an outer context, and is considered
128    --    to terminate the sequence of statements.
129
130    --    If the keyword occurs to the right of, or in the expected column of
131    --    the end for the current sequence, then an error message is output,
132    --    the keyword together with its associated context is skipped, and
133    --    the statement scan continues until another terminator is found.
134
135    --  Note that the first action means that control can return to the caller
136    --  with Token set to a terminator other than one of those specified by the
137    --  SS parameter. The caller should treat such a case as equivalent to END.
138
139    --  In addition, the flag SS_Flags.Sreq is set to True to indicate that at
140    --  least one real statement (other than a pragma) is required in the
141    --  statement sequence. During the processing of the sequence, this
142    --  flag is manipulated to indicate the current status of the requirement
143    --  for a statement. For example, it is turned off by the occurrence of a
144    --  statement, and back on by a label (which requires a following statement)
145
146    --  Error recovery: cannot raise Error_Resync. If an error occurs during
147    --  parsing a statement, then the scan pointer is advanced past the next
148    --  semicolon and the parse continues.
149
150    function P_Sequence_Of_Statements (SS_Flags : SS_Rec) return List_Id is
151
152       Statement_Required : Boolean;
153       --  This flag indicates if a subsequent statement (other than a pragma)
154       --  is required. It is initialized from the Sreq flag, and modified as
155       --  statements are scanned (a statement turns it off, and a label turns
156       --  it back on again since a statement must follow a label).
157       --  Note : this final requirement is lifted in Ada 2012.
158
159       Statement_Seen : Boolean;
160       --  In Ada 2012, a label can end a sequence of statements, but the
161       --  sequence cannot contain only labels. This flag is set whenever a
162       --  label is encountered, to enforce this rule at the end of a sequence.
163
164       Declaration_Found : Boolean := False;
165       --  This flag is set True if a declaration is encountered, so that the
166       --  error message about declarations in the statement part is only
167       --  given once for a given sequence of statements.
168
169       Scan_State_Label : Saved_Scan_State;
170       Scan_State       : Saved_Scan_State;
171
172       Statement_List : List_Id;
173       Block_Label    : Name_Id;
174       Id_Node        : Node_Id;
175       Name_Node      : Node_Id;
176
177       procedure Junk_Declaration;
178       --  Procedure called to handle error of declaration encountered in
179       --  statement sequence.
180
181       procedure Test_Statement_Required;
182       --  Flag error if Statement_Required flag set
183
184       ----------------------
185       -- Junk_Declaration --
186       ----------------------
187
188       procedure Junk_Declaration is
189       begin
190          if (not Declaration_Found) or All_Errors_Mode then
191             Error_Msg_SC -- CODEFIX
192               ("declarations must come before BEGIN");
193             Declaration_Found := True;
194          end if;
195
196          Skip_Declaration (Statement_List);
197       end Junk_Declaration;
198
199       -----------------------------
200       -- Test_Statement_Required --
201       -----------------------------
202
203       procedure Test_Statement_Required is
204          function All_Pragmas return Boolean;
205          --  Return True if statement list is all pragmas
206
207          -----------------
208          -- All_Pragmas --
209          -----------------
210
211          function All_Pragmas return Boolean is
212             S : Node_Id;
213          begin
214             S := First (Statement_List);
215             while Present (S) loop
216                if Nkind (S) /= N_Pragma then
217                   return False;
218                else
219                   Next (S);
220                end if;
221             end loop;
222
223             return True;
224          end All_Pragmas;
225
226       --  Start of processing for Test_Statement_Required
227
228       begin
229          if Statement_Required then
230
231             --  Check no statement required after label in Ada 2012, and that
232             --  it is OK to have nothing but pragmas in a statement sequence.
233
234             if Ada_Version >= Ada_2012
235               and then not Is_Empty_List (Statement_List)
236               and then
237                 ((Nkind (Last (Statement_List)) = N_Label
238                    and then Statement_Seen)
239                 or else All_Pragmas)
240             then
241                declare
242                   Null_Stm : constant Node_Id :=
243                                Make_Null_Statement (Token_Ptr);
244                begin
245                   Set_Comes_From_Source (Null_Stm, False);
246                   Append_To (Statement_List, Null_Stm);
247                end;
248
249             --  If not Ada 2012, or not special case above, give error message
250
251             else
252                Error_Msg_BC -- CODEFIX
253                  ("statement expected");
254             end if;
255          end if;
256       end Test_Statement_Required;
257
258    --  Start of processing for P_Sequence_Of_Statements
259
260    begin
261       Statement_List := New_List;
262       Statement_Required := SS_Flags.Sreq;
263       Statement_Seen     := False;
264
265       loop
266          Ignore (Tok_Semicolon);
267
268          begin
269             if Style_Check then
270                Style.Check_Indentation;
271             end if;
272
273             --  Deal with reserved identifier (in assignment or call)
274
275             if Is_Reserved_Identifier then
276                Save_Scan_State (Scan_State); -- at possible bad identifier
277                Scan; -- and scan past it
278
279                --  We have an reserved word which is spelled in identifier
280                --  style, so the question is whether it really is intended
281                --  to be an identifier.
282
283                if
284                   --  If followed by a semicolon, then it is an identifier,
285                   --  with the exception of the cases tested for below.
286
287                   (Token = Tok_Semicolon
288                     and then Prev_Token /= Tok_Return
289                     and then Prev_Token /= Tok_Null
290                     and then Prev_Token /= Tok_Raise
291                     and then Prev_Token /= Tok_End
292                     and then Prev_Token /= Tok_Exit)
293
294                   --  If followed by colon, colon-equal, or dot, then we
295                   --  definitely  have an identifier (could not be reserved)
296
297                   or else Token = Tok_Colon
298                   or else Token = Tok_Colon_Equal
299                   or else Token = Tok_Dot
300
301                   --  Left paren means we have an identifier except for those
302                   --  reserved words that can legitimately be followed by a
303                   --  left paren.
304
305                   or else
306                     (Token = Tok_Left_Paren
307                       and then Prev_Token /= Tok_Case
308                       and then Prev_Token /= Tok_Delay
309                       and then Prev_Token /= Tok_If
310                       and then Prev_Token /= Tok_Elsif
311                       and then Prev_Token /= Tok_Return
312                       and then Prev_Token /= Tok_When
313                       and then Prev_Token /= Tok_While
314                       and then Prev_Token /= Tok_Separate)
315                then
316                   --  Here we have an apparent reserved identifier and the
317                   --  token past it is appropriate to this usage (and would
318                   --  be a definite error if this is not an identifier). What
319                   --  we do is to use P_Identifier to fix up the identifier,
320                   --  and then fall into the normal processing.
321
322                   Restore_Scan_State (Scan_State); -- back to the ID
323                   Scan_Reserved_Identifier (Force_Msg => False);
324
325                   --  Not a reserved identifier after all (or at least we can't
326                   --  be sure that it is), so reset the scan and continue.
327
328                else
329                   Restore_Scan_State (Scan_State); -- back to the reserved word
330                end if;
331             end if;
332
333             --  Now look to see what kind of statement we have
334
335             case Token is
336
337                --  Case of end or EOF
338
339                when Tok_End | Tok_EOF =>
340
341                   --  These tokens always terminate the statement sequence
342
343                   Test_Statement_Required;
344                   exit;
345
346                --  Case of ELSIF
347
348                when Tok_Elsif =>
349
350                   --  Terminate if Eftm set or if the ELSIF is to the left
351                   --  of the expected column of the end for this sequence
352
353                   if SS_Flags.Eftm
354                      or else Start_Column < Scope.Table (Scope.Last).Ecol
355                   then
356                      Test_Statement_Required;
357                      exit;
358
359                   --  Otherwise complain and skip past ELSIF Condition then
360
361                   else
362                      Error_Msg_SC ("ELSIF not allowed here");
363                      Scan; -- past ELSIF
364                      Discard_Junk_Node (P_Expression_No_Right_Paren);
365                      Then_Scan;
366                      Statement_Required := False;
367                   end if;
368
369                --  Case of ELSE
370
371                when Tok_Else =>
372
373                   --  Terminate if Eltm set or if the else is to the left
374                   --  of the expected column of the end for this sequence
375
376                   if SS_Flags.Eltm
377                      or else Start_Column < Scope.Table (Scope.Last).Ecol
378                   then
379                      Test_Statement_Required;
380                      exit;
381
382                   --  Otherwise complain and skip past else
383
384                   else
385                      Error_Msg_SC ("ELSE not allowed here");
386                      Scan; -- past ELSE
387                      Statement_Required := False;
388                   end if;
389
390                --  Case of exception
391
392                when Tok_Exception =>
393                   Test_Statement_Required;
394
395                   --  If Extm not set and the exception is not to the left of
396                   --  the expected column of the end for this sequence, then we
397                   --  assume it belongs to the current sequence, even though it
398                   --  is not permitted.
399
400                   if not SS_Flags.Extm and then
401                      Start_Column >= Scope.Table (Scope.Last).Ecol
402
403                   then
404                      Error_Msg_SC ("exception handler not permitted here");
405                      Scan; -- past EXCEPTION
406                      Discard_Junk_List (Parse_Exception_Handlers);
407                   end if;
408
409                   --  Always return, in the case where we scanned out handlers
410                   --  that we did not expect, Parse_Exception_Handlers returned
411                   --  with Token being either end or EOF, so we are OK.
412
413                   exit;
414
415                --  Case of OR
416
417                when Tok_Or =>
418
419                   --  Terminate if Ortm set or if the or is to the left of the
420                   --  expected column of the end for this sequence.
421
422                   if SS_Flags.Ortm
423                      or else Start_Column < Scope.Table (Scope.Last).Ecol
424                   then
425                      Test_Statement_Required;
426                      exit;
427
428                   --  Otherwise complain and skip past or
429
430                   else
431                      Error_Msg_SC ("OR not allowed here");
432                      Scan; -- past or
433                      Statement_Required := False;
434                   end if;
435
436                --  Case of THEN (deal also with THEN ABORT)
437
438                when Tok_Then =>
439                   Save_Scan_State (Scan_State); -- at THEN
440                   Scan; -- past THEN
441
442                   --  Terminate if THEN ABORT allowed (ATC case)
443
444                   exit when SS_Flags.Tatm and then Token = Tok_Abort;
445
446                   --  Otherwise we treat THEN as some kind of mess where we did
447                   --  not see the associated IF, but we pick up assuming it had
448                   --  been there!
449
450                   Restore_Scan_State (Scan_State); -- to THEN
451                   Append_To (Statement_List, P_If_Statement);
452                   Statement_Required := False;
453
454                --  Case of WHEN (error because we are not in a case)
455
456                when Tok_When | Tok_Others =>
457
458                   --  Terminate if Whtm set or if the WHEN is to the left of
459                   --  the expected column of the end for this sequence.
460
461                   if SS_Flags.Whtm
462                      or else Start_Column < Scope.Table (Scope.Last).Ecol
463                   then
464                      Test_Statement_Required;
465                      exit;
466
467                   --  Otherwise complain and skip when Choice {| Choice} =>
468
469                   else
470                      Error_Msg_SC ("WHEN not allowed here");
471                      Scan; -- past when
472                      Discard_Junk_List (P_Discrete_Choice_List);
473                      TF_Arrow;
474                      Statement_Required := False;
475                   end if;
476
477                --  Cases of statements starting with an identifier
478
479                when Tok_Identifier =>
480                   Check_Bad_Layout;
481
482                   --  Save scan pointers and line number in case block label
483
484                   Id_Node := Token_Node;
485                   Block_Label := Token_Name;
486                   Save_Scan_State (Scan_State_Label); -- at possible label
487                   Scan; -- past Id
488
489                   --  Check for common case of assignment, since it occurs
490                   --  frequently, and we want to process it efficiently.
491
492                   if Token = Tok_Colon_Equal then
493                      Scan; -- past the colon-equal
494                      Append_To (Statement_List,
495                        P_Assignment_Statement (Id_Node));
496                      Statement_Required := False;
497
498                   --  Check common case of procedure call, another case that
499                   --  we want to speed up as much as possible.
500
501                   elsif Token = Tok_Semicolon then
502                      Append_To (Statement_List,
503                        P_Statement_Name (Id_Node));
504                      Scan; -- past semicolon
505                      Statement_Required := False;
506
507                   --  Check for case of "go to" in place of "goto"
508
509                   elsif Token = Tok_Identifier
510                     and then Block_Label = Name_Go
511                     and then Token_Name = Name_To
512                   then
513                      Error_Msg_SP -- CODEFIX
514                        ("goto is one word");
515                      Append_To (Statement_List, P_Goto_Statement);
516                      Statement_Required := False;
517
518                   --  Check common case of = used instead of :=, just so we
519                   --  give a better error message for this special misuse.
520
521                   elsif Token = Tok_Equal then
522                      T_Colon_Equal; -- give := expected message
523                      Append_To (Statement_List,
524                        P_Assignment_Statement (Id_Node));
525                      Statement_Required := False;
526
527                   --  Check case of loop label or block label
528
529                   elsif Token = Tok_Colon
530                     or else (Token in Token_Class_Labeled_Stmt
531                               and then not Token_Is_At_Start_Of_Line)
532                   then
533                      T_Colon; -- past colon (if there, or msg for missing one)
534
535                      --  Test for more than one label
536
537                      loop
538                         exit when Token /= Tok_Identifier;
539                         Save_Scan_State (Scan_State); -- at second Id
540                         Scan; -- past Id
541
542                         if Token = Tok_Colon then
543                            Error_Msg_SP
544                               ("only one label allowed on block or loop");
545                            Scan; -- past colon on extra label
546
547                            --  Use the second label as the "real" label
548
549                            Scan_State_Label := Scan_State;
550
551                            --  We will set Error_name as the Block_Label since
552                            --  we really don't know which of the labels might
553                            --  be used at the end of the loop or block!
554
555                            Block_Label := Error_Name;
556
557                         --  If Id with no colon, then backup to point to the
558                         --  Id and we will issue the message below when we try
559                         --  to scan out the statement as some other form.
560
561                         else
562                            Restore_Scan_State (Scan_State); -- to second Id
563                            exit;
564                         end if;
565                      end loop;
566
567                      --  Loop_Statement (labeled Loop_Statement)
568
569                      if Token = Tok_Loop then
570                         Append_To (Statement_List,
571                           P_Loop_Statement (Id_Node));
572
573                      --  While statement (labeled loop statement with WHILE)
574
575                      elsif Token = Tok_While then
576                         Append_To (Statement_List,
577                           P_While_Statement (Id_Node));
578
579                      --  Declare statement (labeled block statement with
580                      --  DECLARE part)
581
582                      elsif Token = Tok_Declare then
583                         Append_To (Statement_List,
584                           P_Declare_Statement (Id_Node));
585
586                      --  Begin statement (labeled block statement with no
587                      --  DECLARE part)
588
589                      elsif Token = Tok_Begin then
590                         Append_To (Statement_List,
591                           P_Begin_Statement (Id_Node));
592
593                      --  For statement (labeled loop statement with FOR)
594
595                      elsif Token = Tok_For then
596                         Append_To (Statement_List,
597                           P_For_Statement (Id_Node));
598
599                      --  Improper statement follows label. If we have an
600                      --  expression token, then assume the colon was part
601                      --  of a misplaced declaration.
602
603                      elsif Token not in Token_Class_Eterm then
604                         Restore_Scan_State (Scan_State_Label);
605                         Junk_Declaration;
606
607                      --  Otherwise complain we have inappropriate statement
608
609                      else
610                         Error_Msg_AP
611                           ("loop or block statement must follow label");
612                      end if;
613
614                      Statement_Required := False;
615
616                   --  Here we have an identifier followed by something
617                   --  other than a colon, semicolon or assignment symbol.
618                   --  The only valid possibility is a name extension symbol
619
620                   elsif Token in Token_Class_Namext then
621                      Restore_Scan_State (Scan_State_Label); -- to Id
622                      Name_Node := P_Name;
623
624                      --  Skip junk right parens in this context
625
626                      Ignore (Tok_Right_Paren);
627
628                      --  Check context following call
629
630                      if Token = Tok_Colon_Equal then
631                         Scan; -- past colon equal
632                         Append_To (Statement_List,
633                           P_Assignment_Statement (Name_Node));
634                         Statement_Required := False;
635
636                      --  Check common case of = used instead of :=
637
638                      elsif Token = Tok_Equal then
639                         T_Colon_Equal; -- give := expected message
640                         Append_To (Statement_List,
641                           P_Assignment_Statement (Name_Node));
642                         Statement_Required := False;
643
644                      --  Check apostrophe cases
645
646                      elsif Token = Tok_Apostrophe then
647                         Append_To (Statement_List,
648                           P_Code_Statement (Name_Node));
649                         Statement_Required := False;
650
651                      --  The only other valid item after a name is ; which
652                      --  means that the item we just scanned was a call.
653
654                      elsif Token = Tok_Semicolon then
655                         Append_To (Statement_List,
656                           P_Statement_Name (Name_Node));
657                         Scan; -- past semicolon
658                         Statement_Required := False;
659
660                      --  A slash following an identifier or a selected
661                      --  component in this situation is most likely a period
662                      --  (see location of keys on keyboard).
663
664                      elsif Token = Tok_Slash
665                        and then (Nkind (Name_Node) = N_Identifier
666                                    or else
667                                  Nkind (Name_Node) = N_Selected_Component)
668                      then
669                         Error_Msg_SC -- CODEFIX
670                           ("""/"" should be "".""");
671                         Statement_Required := False;
672                         raise Error_Resync;
673
674                      --  Else we have a missing semicolon
675
676                      else
677                         TF_Semicolon;
678                         Statement_Required := False;
679                      end if;
680
681                   --  If junk after identifier, check if identifier is an
682                   --  instance of an incorrectly spelled keyword. If so, we
683                   --  do nothing. The Bad_Spelling_Of will have reset Token
684                   --  to the appropriate keyword, so the next time round the
685                   --  loop we will process the modified token. Note that we
686                   --  check for ELSIF before ELSE here. That's not accidental.
687                   --  We don't want to identify a misspelling of ELSE as
688                   --  ELSIF, and in particular we do not want to treat ELSEIF
689                   --  as ELSE IF.
690
691                   else
692                      Restore_Scan_State (Scan_State_Label); -- to identifier
693
694                      if Bad_Spelling_Of (Tok_Abort)
695                        or else Bad_Spelling_Of (Tok_Accept)
696                        or else Bad_Spelling_Of (Tok_Case)
697                        or else Bad_Spelling_Of (Tok_Declare)
698                        or else Bad_Spelling_Of (Tok_Delay)
699                        or else Bad_Spelling_Of (Tok_Elsif)
700                        or else Bad_Spelling_Of (Tok_Else)
701                        or else Bad_Spelling_Of (Tok_End)
702                        or else Bad_Spelling_Of (Tok_Exception)
703                        or else Bad_Spelling_Of (Tok_Exit)
704                        or else Bad_Spelling_Of (Tok_For)
705                        or else Bad_Spelling_Of (Tok_Goto)
706                        or else Bad_Spelling_Of (Tok_If)
707                        or else Bad_Spelling_Of (Tok_Loop)
708                        or else Bad_Spelling_Of (Tok_Or)
709                        or else Bad_Spelling_Of (Tok_Pragma)
710                        or else Bad_Spelling_Of (Tok_Raise)
711                        or else Bad_Spelling_Of (Tok_Requeue)
712                        or else Bad_Spelling_Of (Tok_Return)
713                        or else Bad_Spelling_Of (Tok_Select)
714                        or else Bad_Spelling_Of (Tok_When)
715                        or else Bad_Spelling_Of (Tok_While)
716                      then
717                         null;
718
719                      --  If not a bad spelling, then we really have junk
720
721                      else
722                         Scan; -- past identifier again
723
724                         --  If next token is first token on line, then we
725                         --  consider that we were missing a semicolon after
726                         --  the identifier, and process it as a procedure
727                         --  call with no parameters.
728
729                         if Token_Is_At_Start_Of_Line then
730                            Append_To (Statement_List,
731                              P_Statement_Name (Id_Node));
732                            T_Semicolon; -- to give error message
733                            Statement_Required := False;
734
735                         --  Otherwise we give a missing := message and
736                         --  simply abandon the junk that is there now.
737
738                         else
739                            T_Colon_Equal; -- give := expected message
740                            raise Error_Resync;
741                         end if;
742
743                      end if;
744                   end if;
745
746                --  Statement starting with operator symbol. This could be
747                --  a call, a name starting an assignment, or a qualified
748                --  expression.
749
750                when Tok_Operator_Symbol =>
751                   Check_Bad_Layout;
752                   Name_Node := P_Name;
753
754                   --  An attempt at a range attribute or a qualified expression
755                   --  must be illegal here (a code statement cannot possibly
756                   --  allow qualification by a function name).
757
758                   if Token = Tok_Apostrophe then
759                      Error_Msg_SC ("apostrophe illegal here");
760                      raise Error_Resync;
761                   end if;
762
763                   --  Scan possible assignment if we have a name
764
765                   if Expr_Form = EF_Name
766                     and then Token = Tok_Colon_Equal
767                   then
768                      Scan; -- past colon equal
769                      Append_To (Statement_List,
770                        P_Assignment_Statement (Name_Node));
771                   else
772                      Append_To (Statement_List,
773                        P_Statement_Name (Name_Node));
774                   end if;
775
776                   TF_Semicolon;
777                   Statement_Required := False;
778
779                --  Label starting with << which must precede real statement
780                --  Note: in Ada 2012, the label may end the sequence.
781
782                when Tok_Less_Less =>
783                   if Present (Last (Statement_List))
784                     and then Nkind (Last (Statement_List)) /= N_Label
785                   then
786                      Statement_Seen := True;
787                   end if;
788
789                   Append_To (Statement_List, P_Label);
790                   Statement_Required := True;
791
792                --  Pragma appearing as a statement in a statement sequence
793
794                when Tok_Pragma =>
795                   Check_Bad_Layout;
796                   Append_To (Statement_List, P_Pragma);
797
798                --  Abort_Statement
799
800                when Tok_Abort =>
801                   Check_Bad_Layout;
802                   Append_To (Statement_List, P_Abort_Statement);
803                   Statement_Required := False;
804
805                --  Accept_Statement
806
807                when Tok_Accept =>
808                   Check_Bad_Layout;
809                   Append_To (Statement_List, P_Accept_Statement);
810                   Statement_Required := False;
811
812                --  Begin_Statement (Block_Statement with no declare, no label)
813
814                when Tok_Begin =>
815                   Check_Bad_Layout;
816                   Append_To (Statement_List, P_Begin_Statement);
817                   Statement_Required := False;
818
819                --  Case_Statement
820
821                when Tok_Case =>
822                   Check_Bad_Layout;
823                   Append_To (Statement_List, P_Case_Statement);
824                   Statement_Required := False;
825
826                --  Block_Statement with DECLARE and no label
827
828                when Tok_Declare =>
829                   Check_Bad_Layout;
830                   Append_To (Statement_List, P_Declare_Statement);
831                   Statement_Required := False;
832
833                --  Delay_Statement
834
835                when Tok_Delay =>
836                   Check_Bad_Layout;
837                   Append_To (Statement_List, P_Delay_Statement);
838                   Statement_Required := False;
839
840                --  Exit_Statement
841
842                when Tok_Exit =>
843                   Check_Bad_Layout;
844                   Append_To (Statement_List, P_Exit_Statement);
845                   Statement_Required := False;
846
847                --  Loop_Statement with FOR and no label
848
849                when Tok_For =>
850                   Check_Bad_Layout;
851                   Append_To (Statement_List, P_For_Statement);
852                   Statement_Required := False;
853
854                --  Goto_Statement
855
856                when Tok_Goto =>
857                   Check_Bad_Layout;
858                   Append_To (Statement_List, P_Goto_Statement);
859                   Statement_Required := False;
860
861                --  If_Statement
862
863                when Tok_If =>
864                   Check_Bad_Layout;
865                   Append_To (Statement_List, P_If_Statement);
866                   Statement_Required := False;
867
868                --  Loop_Statement
869
870                when Tok_Loop =>
871                   Check_Bad_Layout;
872                   Append_To (Statement_List, P_Loop_Statement);
873                   Statement_Required := False;
874
875                --  Null_Statement
876
877                when Tok_Null =>
878                   Check_Bad_Layout;
879                   Append_To (Statement_List, P_Null_Statement);
880                   Statement_Required := False;
881
882                --  Raise_Statement
883
884                when Tok_Raise =>
885                   Check_Bad_Layout;
886                   Append_To (Statement_List, P_Raise_Statement);
887                   Statement_Required := False;
888
889                --  Requeue_Statement
890
891                when Tok_Requeue =>
892                   Check_Bad_Layout;
893                   Append_To (Statement_List, P_Requeue_Statement);
894                   Statement_Required := False;
895
896                --  Return_Statement
897
898                when Tok_Return =>
899                   Check_Bad_Layout;
900                   Append_To (Statement_List, P_Return_Statement);
901                   Statement_Required := False;
902
903                --  Select_Statement
904
905                when Tok_Select =>
906                   Check_Bad_Layout;
907                   Append_To (Statement_List, P_Select_Statement);
908                   Statement_Required := False;
909
910                --  While_Statement (Block_Statement with while and no loop)
911
912                when Tok_While =>
913                   Check_Bad_Layout;
914                   Append_To (Statement_List, P_While_Statement);
915                   Statement_Required := False;
916
917                --  Anything else is some kind of junk, signal an error message
918                --  and then raise Error_Resync, to merge with the normal
919                --  handling of a bad statement.
920
921                when others =>
922
923                   if Token in Token_Class_Declk then
924                      Junk_Declaration;
925
926                   else
927                      Error_Msg_BC -- CODEFIX
928                        ("statement expected");
929                      raise Error_Resync;
930                   end if;
931             end case;
932
933          --  On error resynchronization, skip past next semicolon, and, since
934          --  we are still in the statement loop, look for next statement. We
935          --  set Statement_Required False to avoid an unnecessary error message
936          --  complaining that no statement was found (i.e. we consider the
937          --  junk to satisfy the requirement for a statement being present).
938
939          exception
940             when Error_Resync =>
941                Resync_Past_Semicolon_Or_To_Loop_Or_Then;
942                Statement_Required := False;
943          end;
944
945          exit when SS_Flags.Unco;
946
947       end loop;
948
949       return Statement_List;
950
951    end P_Sequence_Of_Statements;
952
953    --------------------
954    -- 5.1  Statement --
955    --------------------
956
957    --  Parsed by P_Sequence_Of_Statements (5.1), except for the case
958    --  of a statement of the form of a name, which is handled here. The
959    --  argument passed in is the tree for the name which has been scanned
960    --  The returned value is the corresponding statement form.
961
962    --  This routine is also used by Par.Prag for processing the procedure
963    --  call that appears as the second argument of a pragma Assert.
964
965    --  Error recovery: cannot raise Error_Resync
966
967    function P_Statement_Name (Name_Node : Node_Id) return Node_Id is
968       Stmt_Node : Node_Id;
969
970    begin
971       --  Case of Indexed component, which is a procedure call with arguments
972
973       if Nkind (Name_Node) = N_Indexed_Component then
974          declare
975             Prefix_Node : constant Node_Id := Prefix (Name_Node);
976             Exprs_Node  : constant List_Id := Expressions (Name_Node);
977
978          begin
979             Change_Node (Name_Node, N_Procedure_Call_Statement);
980             Set_Name (Name_Node, Prefix_Node);
981             Set_Parameter_Associations (Name_Node, Exprs_Node);
982             return Name_Node;
983          end;
984
985       --  Case of function call node, which is a really a procedure call
986
987       elsif Nkind (Name_Node) = N_Function_Call then
988          declare
989             Fname_Node  : constant Node_Id := Name (Name_Node);
990             Params_List : constant List_Id :=
991                             Parameter_Associations (Name_Node);
992
993          begin
994             Change_Node (Name_Node, N_Procedure_Call_Statement);
995             Set_Name (Name_Node, Fname_Node);
996             Set_Parameter_Associations (Name_Node, Params_List);
997             return Name_Node;
998          end;
999
1000       --  Case of call to attribute that denotes a procedure. Here we
1001       --  just leave the attribute reference unchanged.
1002
1003       elsif Nkind (Name_Node) = N_Attribute_Reference
1004         and then Is_Procedure_Attribute_Name (Attribute_Name (Name_Node))
1005       then
1006          return Name_Node;
1007
1008       --  All other cases of names are parameterless procedure calls
1009
1010       else
1011          Stmt_Node :=
1012            New_Node (N_Procedure_Call_Statement, Sloc (Name_Node));
1013          Set_Name (Stmt_Node, Name_Node);
1014          return Stmt_Node;
1015       end if;
1016
1017    end P_Statement_Name;
1018
1019    ---------------------------
1020    -- 5.1  Simple Statement --
1021    ---------------------------
1022
1023    --  Parsed by P_Sequence_Of_Statements (5.1)
1024
1025    -----------------------------
1026    -- 5.1  Compound Statement --
1027    -----------------------------
1028
1029    --  Parsed by P_Sequence_Of_Statements (5.1)
1030
1031    -------------------------
1032    -- 5.1  Null Statement --
1033    -------------------------
1034
1035    --  NULL_STATEMENT ::= null;
1036
1037    --  The caller has already checked that the current token is null
1038
1039    --  Error recovery: cannot raise Error_Resync
1040
1041    function P_Null_Statement return Node_Id is
1042       Null_Stmt_Node : Node_Id;
1043
1044    begin
1045       Null_Stmt_Node := New_Node (N_Null_Statement, Token_Ptr);
1046       Scan; -- past NULL
1047       TF_Semicolon;
1048       return Null_Stmt_Node;
1049    end P_Null_Statement;
1050
1051    ----------------
1052    -- 5.1  Label --
1053    ----------------
1054
1055    --  LABEL ::= <<label_STATEMENT_IDENTIFIER>>
1056
1057    --  STATEMENT_IDENTIFIER ::= DIRECT_NAME
1058
1059    --  The IDENTIFIER of a STATEMENT_IDENTIFIER shall be an identifier
1060    --  (not an OPERATOR_SYMBOL)
1061
1062    --  The caller has already checked that the current token is <<
1063
1064    --  Error recovery: can raise Error_Resync
1065
1066    function P_Label return Node_Id is
1067       Label_Node : Node_Id;
1068
1069    begin
1070       Label_Node := New_Node (N_Label, Token_Ptr);
1071       Scan; -- past <<
1072       Set_Identifier (Label_Node, P_Identifier (C_Greater_Greater));
1073       T_Greater_Greater;
1074       Append_Elmt (Label_Node, Label_List);
1075       return Label_Node;
1076    end P_Label;
1077
1078    -------------------------------
1079    -- 5.1  Statement Identifier --
1080    -------------------------------
1081
1082    --  Statement label is parsed by P_Label (5.1)
1083
1084    --  Loop label is parsed by P_Loop_Statement (5.5), P_For_Statement (5.5)
1085    --   or P_While_Statement (5.5)
1086
1087    --  Block label is parsed by P_Begin_Statement (5.6) or
1088    --   P_Declare_Statement (5.6)
1089
1090    -------------------------------
1091    -- 5.2  Assignment Statement --
1092    -------------------------------
1093
1094    --  ASSIGNMENT_STATEMENT ::=
1095    --    variable_NAME := EXPRESSION;
1096
1097    --  Error recovery: can raise Error_Resync
1098
1099    function P_Assignment_Statement (LHS : Node_Id) return Node_Id is
1100       Assign_Node : Node_Id;
1101
1102    begin
1103       Assign_Node := New_Node (N_Assignment_Statement, Prev_Token_Ptr);
1104       Set_Name (Assign_Node, LHS);
1105       Set_Expression (Assign_Node, P_Expression_No_Right_Paren);
1106       TF_Semicolon;
1107       return Assign_Node;
1108    end P_Assignment_Statement;
1109
1110    -----------------------
1111    -- 5.3  If Statement --
1112    -----------------------
1113
1114    --  IF_STATEMENT ::=
1115    --    if CONDITION then
1116    --      SEQUENCE_OF_STATEMENTS
1117    --    {elsif CONDITION then
1118    --      SEQUENCE_OF_STATEMENTS}
1119    --    [else
1120    --      SEQUENCE_OF_STATEMENTS]
1121    --    end if;
1122
1123    --  The caller has checked that the initial token is IF (or in the error
1124    --  case of a mysterious THEN, the initial token may simply be THEN, in
1125    --  which case, no condition (or IF) was scanned).
1126
1127    --  Error recovery: can raise Error_Resync
1128
1129    function P_If_Statement return Node_Id is
1130       If_Node    : Node_Id;
1131       Elsif_Node : Node_Id;
1132       Loc        : Source_Ptr;
1133
1134       procedure Add_Elsif_Part;
1135       --  An internal procedure used to scan out a single ELSIF part. On entry
1136       --  the ELSIF (or an ELSE which has been determined should be ELSIF) is
1137       --  scanned out and is in Prev_Token.
1138
1139       procedure Check_If_Column;
1140       --  An internal procedure used to check that THEN, ELSE, or ELSIF
1141       --  appear in the right place if column checking is enabled (i.e. if
1142       --  they are the first token on the line, then they must appear in
1143       --  the same column as the opening IF).
1144
1145       procedure Check_Then_Column;
1146       --  This procedure carries out the style checks for a THEN token
1147       --  Note that the caller has set Loc to the Source_Ptr value for
1148       --  the previous IF or ELSIF token. These checks apply only to a
1149       --  THEN at the start of a line.
1150
1151       function Else_Should_Be_Elsif return Boolean;
1152       --  An internal routine used to do a special error recovery check when
1153       --  an ELSE is encountered. It determines if the ELSE should be treated
1154       --  as an ELSIF. A positive decision (TRUE returned, is made if the ELSE
1155       --  is followed by a sequence of tokens, starting on the same line as
1156       --  the ELSE, which are not expression terminators, followed by a THEN.
1157       --  On entry, the ELSE has been scanned out.
1158
1159       procedure Add_Elsif_Part is
1160       begin
1161          if No (Elsif_Parts (If_Node)) then
1162             Set_Elsif_Parts (If_Node, New_List);
1163          end if;
1164
1165          Elsif_Node := New_Node (N_Elsif_Part, Prev_Token_Ptr);
1166          Loc := Prev_Token_Ptr;
1167          Set_Condition (Elsif_Node, P_Condition);
1168          Check_Then_Column;
1169          Then_Scan;
1170          Set_Then_Statements
1171            (Elsif_Node, P_Sequence_Of_Statements (SS_Eftm_Eltm_Sreq));
1172          Append (Elsif_Node, Elsif_Parts (If_Node));
1173       end Add_Elsif_Part;
1174
1175       procedure Check_If_Column is
1176       begin
1177          if RM_Column_Check and then Token_Is_At_Start_Of_Line
1178            and then Start_Column /= Scope.Table (Scope.Last).Ecol
1179          then
1180             Error_Msg_Col := Scope.Table (Scope.Last).Ecol;
1181             Error_Msg_SC ("(style) this token should be@");
1182          end if;
1183       end Check_If_Column;
1184
1185       procedure Check_Then_Column is
1186       begin
1187          if Token_Is_At_Start_Of_Line and then Token = Tok_Then then
1188             Check_If_Column;
1189
1190             if Style_Check then
1191                Style.Check_Then (Loc);
1192             end if;
1193          end if;
1194       end Check_Then_Column;
1195
1196       function Else_Should_Be_Elsif return Boolean is
1197          Scan_State : Saved_Scan_State;
1198
1199       begin
1200          if Token_Is_At_Start_Of_Line then
1201             return False;
1202
1203          else
1204             Save_Scan_State (Scan_State);
1205
1206             loop
1207                if Token in Token_Class_Eterm then
1208                   Restore_Scan_State (Scan_State);
1209                   return False;
1210                else
1211                   Scan; -- past non-expression terminating token
1212
1213                   if Token = Tok_Then then
1214                      Restore_Scan_State (Scan_State);
1215                      return True;
1216                   end if;
1217                end if;
1218             end loop;
1219          end if;
1220       end Else_Should_Be_Elsif;
1221
1222    --  Start of processing for P_If_Statement
1223
1224    begin
1225       If_Node := New_Node (N_If_Statement, Token_Ptr);
1226
1227       Push_Scope_Stack;
1228       Scope.Table (Scope.Last).Etyp := E_If;
1229       Scope.Table (Scope.Last).Ecol := Start_Column;
1230       Scope.Table (Scope.Last).Sloc := Token_Ptr;
1231       Scope.Table (Scope.Last).Labl := Error;
1232       Scope.Table (Scope.Last).Node := If_Node;
1233
1234       if Token = Tok_If then
1235          Loc := Token_Ptr;
1236          Scan; -- past IF
1237          Set_Condition (If_Node, P_Condition);
1238
1239          --  Deal with misuse of IF expression => used instead
1240          --  of WHEN expression =>
1241
1242          if Token = Tok_Arrow then
1243             Error_Msg_SC -- CODEFIX
1244               ("THEN expected");
1245             Scan; -- past the arrow
1246             Pop_Scope_Stack; -- remove unneeded entry
1247             raise Error_Resync;
1248          end if;
1249
1250          Check_Then_Column;
1251
1252       else
1253          Error_Msg_SC ("no IF for this THEN");
1254          Set_Condition (If_Node, Error);
1255       end if;
1256
1257       Then_Scan;
1258
1259       Set_Then_Statements
1260         (If_Node, P_Sequence_Of_Statements (SS_Eftm_Eltm_Sreq));
1261
1262       --  This loop scans out else and elsif parts
1263
1264       loop
1265          if Token = Tok_Elsif then
1266             Check_If_Column;
1267
1268             if Present (Else_Statements (If_Node)) then
1269                Error_Msg_SP ("ELSIF cannot appear after ELSE");
1270             end if;
1271
1272             Scan; -- past ELSIF
1273             Add_Elsif_Part;
1274
1275          elsif Token = Tok_Else then
1276             Check_If_Column;
1277             Scan; -- past ELSE
1278
1279             if Else_Should_Be_Elsif then
1280                Error_Msg_SP -- CODEFIX
1281                  ("ELSE should be ELSIF");
1282                Add_Elsif_Part;
1283
1284             else
1285                --  Here we have an else that really is an else
1286
1287                if Present (Else_Statements (If_Node)) then
1288                   Error_Msg_SP ("only one ELSE part allowed");
1289                   Append_List
1290                     (P_Sequence_Of_Statements (SS_Eftm_Eltm_Sreq),
1291                      Else_Statements (If_Node));
1292                else
1293                   Set_Else_Statements
1294                     (If_Node, P_Sequence_Of_Statements (SS_Eftm_Eltm_Sreq));
1295                end if;
1296             end if;
1297
1298          --  If anything other than ELSE or ELSIF, exit the loop. The token
1299          --  had better be END (and in fact it had better be END IF), but
1300          --  we will let End_Statements take care of checking that.
1301
1302          else
1303             exit;
1304          end if;
1305       end loop;
1306
1307       End_Statements;
1308       return If_Node;
1309
1310    end P_If_Statement;
1311
1312    --------------------
1313    -- 5.3  Condition --
1314    --------------------
1315
1316    --  CONDITION ::= boolean_EXPRESSION
1317
1318    function P_Condition return Node_Id is
1319       Cond : Node_Id;
1320
1321    begin
1322       Cond := P_Expression_No_Right_Paren;
1323
1324       --  It is never possible for := to follow a condition, so if we get
1325       --  a := we assume it is a mistyped equality. Note that we do not try
1326       --  to reconstruct the tree correctly in this case, but we do at least
1327       --  give an accurate error message.
1328
1329       if Token = Tok_Colon_Equal then
1330          while Token = Tok_Colon_Equal loop
1331             Error_Msg_SC -- CODEFIX
1332               (""":="" should be ""=""");
1333             Scan; -- past junk :=
1334             Discard_Junk_Node (P_Expression_No_Right_Paren);
1335          end loop;
1336
1337          return Cond;
1338
1339       --  Otherwise check for redundant parens
1340
1341       else
1342          if Style_Check
1343            and then Paren_Count (Cond) > 0
1344          then
1345             Style.Check_Xtra_Parens (First_Sloc (Cond));
1346          end if;
1347
1348          --  And return the result
1349
1350          return Cond;
1351       end if;
1352    end P_Condition;
1353
1354    -------------------------
1355    -- 5.4  Case Statement --
1356    -------------------------
1357
1358    --  CASE_STATEMENT ::=
1359    --    case EXPRESSION is
1360    --      CASE_STATEMENT_ALTERNATIVE
1361    --      {CASE_STATEMENT_ALTERNATIVE}
1362    --    end case;
1363
1364    --  The caller has checked that the first token is CASE
1365
1366    --  Can raise Error_Resync
1367
1368    function P_Case_Statement return Node_Id is
1369       Case_Node         : Node_Id;
1370       Alternatives_List : List_Id;
1371       First_When_Loc    : Source_Ptr;
1372
1373    begin
1374       Case_Node := New_Node (N_Case_Statement, Token_Ptr);
1375
1376       Push_Scope_Stack;
1377       Scope.Table (Scope.Last).Etyp := E_Case;
1378       Scope.Table (Scope.Last).Ecol := Start_Column;
1379       Scope.Table (Scope.Last).Sloc := Token_Ptr;
1380       Scope.Table (Scope.Last).Labl := Error;
1381       Scope.Table (Scope.Last).Node := Case_Node;
1382
1383       Scan; -- past CASE
1384       Set_Expression (Case_Node, P_Expression_No_Right_Paren);
1385       TF_Is;
1386
1387       --  Prepare to parse case statement alternatives
1388
1389       Alternatives_List := New_List;
1390       P_Pragmas_Opt (Alternatives_List);
1391       First_When_Loc := Token_Ptr;
1392
1393       --  Loop through case statement alternatives
1394
1395       loop
1396          --  If we have a WHEN or OTHERS, then that's fine keep going. Note
1397          --  that it is a semantic check to ensure the proper use of OTHERS
1398
1399          if Token = Tok_When or else Token = Tok_Others then
1400             Append (P_Case_Statement_Alternative, Alternatives_List);
1401
1402          --  If we have an END, then probably we are at the end of the case
1403          --  but we only exit if Check_End thinks the END was reasonable.
1404
1405          elsif Token = Tok_End then
1406             exit when Check_End;
1407
1408          --  Here if token is other than WHEN, OTHERS or END. We definitely
1409          --  have an error, but the question is whether or not to get out of
1410          --  the case statement. We don't want to get out early, or we will
1411          --  get a slew of junk error messages for subsequent when tokens.
1412
1413          --  If the token is not at the start of the line, or if it is indented
1414          --  with respect to the current case statement, then the best guess is
1415          --  that we are still supposed to be inside the case statement. We
1416          --  complain about the missing WHEN, and discard the junk statements.
1417
1418          elsif not Token_Is_At_Start_Of_Line
1419            or else Start_Column > Scope.Table (Scope.Last).Ecol
1420          then
1421             Error_Msg_BC ("WHEN (case statement alternative) expected");
1422
1423             --  Here is a possibility for infinite looping if we don't make
1424             --  progress. So try to process statements, otherwise exit
1425
1426             declare
1427                Error_Ptr : constant Source_Ptr := Scan_Ptr;
1428             begin
1429                Discard_Junk_List (P_Sequence_Of_Statements (SS_Whtm));
1430                exit when Scan_Ptr = Error_Ptr and then Check_End;
1431             end;
1432
1433          --  Here we have a junk token at the start of the line and it is
1434          --  not indented. If Check_End thinks there is a missing END, then
1435          --  we will get out of the case, otherwise we keep going.
1436
1437          else
1438             exit when Check_End;
1439          end if;
1440       end loop;
1441
1442       --  Make sure we have at least one alternative
1443
1444       if No (First_Non_Pragma (Alternatives_List)) then
1445          Error_Msg
1446             ("WHEN expected, must have at least one alternative in case",
1447              First_When_Loc);
1448          return Error;
1449
1450       else
1451          Set_Alternatives (Case_Node, Alternatives_List);
1452          return Case_Node;
1453       end if;
1454    end P_Case_Statement;
1455
1456    -------------------------------------
1457    -- 5.4  Case Statement Alternative --
1458    -------------------------------------
1459
1460    --  CASE_STATEMENT_ALTERNATIVE ::=
1461    --    when DISCRETE_CHOICE_LIST =>
1462    --      SEQUENCE_OF_STATEMENTS
1463
1464    --  The caller has checked that the initial token is WHEN or OTHERS
1465    --  Error recovery: can raise Error_Resync
1466
1467    function P_Case_Statement_Alternative return Node_Id is
1468       Case_Alt_Node : Node_Id;
1469
1470    begin
1471       if Style_Check then
1472          Style.Check_Indentation;
1473       end if;
1474
1475       Case_Alt_Node := New_Node (N_Case_Statement_Alternative, Token_Ptr);
1476       T_When; -- past WHEN (or give error in OTHERS case)
1477       Set_Discrete_Choices (Case_Alt_Node, P_Discrete_Choice_List);
1478       TF_Arrow;
1479       Set_Statements (Case_Alt_Node, P_Sequence_Of_Statements (SS_Sreq_Whtm));
1480       return Case_Alt_Node;
1481    end P_Case_Statement_Alternative;
1482
1483    -------------------------
1484    -- 5.5  Loop Statement --
1485    -------------------------
1486
1487    --  LOOP_STATEMENT ::=
1488    --    [LOOP_STATEMENT_IDENTIFIER:]
1489    --      [ITERATION_SCHEME] loop
1490    --        SEQUENCE_OF_STATEMENTS
1491    --      end loop [loop_IDENTIFIER];
1492
1493    --  ITERATION_SCHEME ::=
1494    --    while CONDITION
1495    --  | for LOOP_PARAMETER_SPECIFICATION
1496
1497    --  The parsing of loop statements is handled by one of three functions
1498    --  P_Loop_Statement, P_For_Statement or P_While_Statement depending
1499    --  on the initial keyword in the construct (excluding the identifier)
1500
1501    --  P_Loop_Statement
1502
1503    --  This function parses the case where no iteration scheme is present
1504
1505    --  The caller has checked that the initial token is LOOP. The parameter
1506    --  is the node identifiers for the loop label if any (or is set to Empty
1507    --  if there is no loop label).
1508
1509    --  Error recovery : cannot raise Error_Resync
1510
1511    function P_Loop_Statement (Loop_Name : Node_Id := Empty) return Node_Id is
1512       Loop_Node    : Node_Id;
1513       Created_Name : Node_Id;
1514
1515    begin
1516       Push_Scope_Stack;
1517       Scope.Table (Scope.Last).Labl := Loop_Name;
1518       Scope.Table (Scope.Last).Ecol := Start_Column;
1519       Scope.Table (Scope.Last).Sloc := Token_Ptr;
1520       Scope.Table (Scope.Last).Etyp := E_Loop;
1521
1522       Loop_Node := New_Node (N_Loop_Statement, Token_Ptr);
1523       TF_Loop;
1524
1525       if No (Loop_Name) then
1526          Created_Name :=
1527            Make_Identifier (Sloc (Loop_Node),
1528              Chars => Set_Loop_Block_Name ('L'));
1529          Set_Comes_From_Source (Created_Name, False);
1530          Set_Has_Created_Identifier (Loop_Node, True);
1531          Set_Identifier (Loop_Node, Created_Name);
1532          Scope.Table (Scope.Last).Labl := Created_Name;
1533       else
1534          Set_Identifier (Loop_Node, Loop_Name);
1535       end if;
1536
1537       Append_Elmt (Loop_Node, Label_List);
1538       Set_Statements (Loop_Node, P_Sequence_Of_Statements (SS_Sreq));
1539       End_Statements (Loop_Node);
1540       return Loop_Node;
1541    end P_Loop_Statement;
1542
1543    --  P_For_Statement
1544
1545    --  This function parses a loop statement with a FOR iteration scheme
1546
1547    --  The caller has checked that the initial token is FOR. The parameter
1548    --  is the node identifier for the block label if any (or is set to Empty
1549    --  if there is no block label).
1550
1551    --  Note: the caller fills in the Identifier field if a label was present
1552
1553    --  Error recovery: can raise Error_Resync
1554
1555    function P_For_Statement (Loop_Name : Node_Id := Empty) return Node_Id is
1556       Loop_Node        : Node_Id;
1557       Iter_Scheme_Node : Node_Id;
1558       Loop_For_Flag    : Boolean;
1559       Created_Name     : Node_Id;
1560       Spec             : Node_Id;
1561
1562    begin
1563       Push_Scope_Stack;
1564       Scope.Table (Scope.Last).Labl := Loop_Name;
1565       Scope.Table (Scope.Last).Ecol := Start_Column;
1566       Scope.Table (Scope.Last).Sloc := Token_Ptr;
1567       Scope.Table (Scope.Last).Etyp := E_Loop;
1568
1569       Loop_For_Flag := (Prev_Token = Tok_Loop);
1570       Scan; -- past FOR
1571       Iter_Scheme_Node := New_Node (N_Iteration_Scheme, Token_Ptr);
1572       Spec := P_Loop_Parameter_Specification;
1573       if Nkind (Spec) = N_Loop_Parameter_Specification then
1574          Set_Loop_Parameter_Specification (Iter_Scheme_Node, Spec);
1575       else
1576          Set_Iterator_Specification (Iter_Scheme_Node, Spec);
1577       end if;
1578
1579       --  The following is a special test so that a miswritten for loop such
1580       --  as "loop for I in 1..10;" is handled nicely, without making an extra
1581       --  entry in the scope stack. We don't bother to actually fix up the
1582       --  tree in this case since it's not worth the effort. Instead we just
1583       --  eat up the loop junk, leaving the entry for what now looks like an
1584       --  unmodified loop intact.
1585
1586       if Loop_For_Flag and then Token = Tok_Semicolon then
1587          Error_Msg_SC ("LOOP belongs here, not before FOR");
1588          Pop_Scope_Stack;
1589          return Error;
1590
1591       --  Normal case
1592
1593       else
1594          Loop_Node := New_Node (N_Loop_Statement, Token_Ptr);
1595
1596          if No (Loop_Name) then
1597             Created_Name :=
1598               Make_Identifier (Sloc (Loop_Node),
1599                 Chars => Set_Loop_Block_Name ('L'));
1600             Set_Comes_From_Source (Created_Name, False);
1601             Set_Has_Created_Identifier (Loop_Node, True);
1602             Set_Identifier (Loop_Node, Created_Name);
1603             Scope.Table (Scope.Last).Labl := Created_Name;
1604          else
1605             Set_Identifier (Loop_Node, Loop_Name);
1606          end if;
1607
1608          TF_Loop;
1609          Set_Statements (Loop_Node, P_Sequence_Of_Statements (SS_Sreq));
1610          End_Statements (Loop_Node);
1611          Set_Iteration_Scheme (Loop_Node, Iter_Scheme_Node);
1612          Append_Elmt (Loop_Node, Label_List);
1613          return Loop_Node;
1614       end if;
1615    end P_For_Statement;
1616
1617    --  P_While_Statement
1618
1619    --  This procedure scans a loop statement with a WHILE iteration scheme
1620
1621    --  The caller has checked that the initial token is WHILE. The parameter
1622    --  is the node identifier for the block label if any (or is set to Empty
1623    --  if there is no block label).
1624
1625    --  Error recovery: cannot raise Error_Resync
1626
1627    function P_While_Statement (Loop_Name : Node_Id := Empty) return Node_Id is
1628       Loop_Node        : Node_Id;
1629       Iter_Scheme_Node : Node_Id;
1630       Loop_While_Flag  : Boolean;
1631       Created_Name     : Node_Id;
1632
1633    begin
1634       Push_Scope_Stack;
1635       Scope.Table (Scope.Last).Labl := Loop_Name;
1636       Scope.Table (Scope.Last).Ecol := Start_Column;
1637       Scope.Table (Scope.Last).Sloc := Token_Ptr;
1638       Scope.Table (Scope.Last).Etyp := E_Loop;
1639
1640       Loop_While_Flag := (Prev_Token = Tok_Loop);
1641       Iter_Scheme_Node := New_Node (N_Iteration_Scheme, Token_Ptr);
1642       Scan; -- past WHILE
1643       Set_Condition (Iter_Scheme_Node, P_Condition);
1644
1645       --  The following is a special test so that a miswritten for loop such
1646       --  as "loop while I > 10;" is handled nicely, without making an extra
1647       --  entry in the scope stack. We don't bother to actually fix up the
1648       --  tree in this case since it's not worth the effort. Instead we just
1649       --  eat up the loop junk, leaving the entry for what now looks like an
1650       --  unmodified loop intact.
1651
1652       if Loop_While_Flag and then Token = Tok_Semicolon then
1653          Error_Msg_SC ("LOOP belongs here, not before WHILE");
1654          Pop_Scope_Stack;
1655          return Error;
1656
1657       --  Normal case
1658
1659       else
1660          Loop_Node := New_Node (N_Loop_Statement, Token_Ptr);
1661          TF_Loop;
1662
1663          if No (Loop_Name) then
1664             Created_Name :=
1665               Make_Identifier (Sloc (Loop_Node),
1666                 Chars => Set_Loop_Block_Name ('L'));
1667             Set_Comes_From_Source (Created_Name, False);
1668             Set_Has_Created_Identifier (Loop_Node, True);
1669             Set_Identifier (Loop_Node, Created_Name);
1670             Scope.Table (Scope.Last).Labl := Created_Name;
1671          else
1672             Set_Identifier (Loop_Node, Loop_Name);
1673          end if;
1674
1675          Set_Statements (Loop_Node, P_Sequence_Of_Statements (SS_Sreq));
1676          End_Statements (Loop_Node);
1677          Set_Iteration_Scheme (Loop_Node, Iter_Scheme_Node);
1678          Append_Elmt (Loop_Node, Label_List);
1679          return Loop_Node;
1680       end if;
1681    end P_While_Statement;
1682
1683    ---------------------------------------
1684    -- 5.5  Loop Parameter Specification --
1685    ---------------------------------------
1686
1687    --  LOOP_PARAMETER_SPECIFICATION ::=
1688    --    DEFINING_IDENTIFIER in [reverse] DISCRETE_SUBTYPE_DEFINITION
1689
1690    --  Error recovery: cannot raise Error_Resync
1691
1692    function P_Loop_Parameter_Specification return Node_Id is
1693       Loop_Param_Specification_Node : Node_Id;
1694
1695       ID_Node    : Node_Id;
1696       Scan_State : Saved_Scan_State;
1697
1698    begin
1699
1700       Save_Scan_State (Scan_State);
1701       ID_Node := P_Defining_Identifier (C_In);
1702
1703       --  If the next token is OF, it indicates an Ada 2012 iterator. If the
1704       --  next token is a colon, this is also an Ada 2012 iterator, including a
1705       --  subtype indication for the loop parameter. Otherwise we parse the
1706       --  construct as a loop parameter specification. Note that the form
1707       --  "for A in B" is ambiguous, and must be resolved semantically: if B
1708       --  is a discrete subtype this is a loop specification, but if it is an
1709       --  expression it is an iterator specification. Ambiguity is resolved
1710       --  during analysis of the loop parameter specification.
1711
1712       if Token = Tok_Of or else Token = Tok_Colon then
1713          return P_Iterator_Specification (ID_Node);
1714       end if;
1715
1716       Loop_Param_Specification_Node :=
1717         New_Node (N_Loop_Parameter_Specification, Token_Ptr);
1718       Set_Defining_Identifier (Loop_Param_Specification_Node, ID_Node);
1719
1720       if Token = Tok_Left_Paren then
1721          Error_Msg_SC ("subscripted loop parameter not allowed");
1722          Restore_Scan_State (Scan_State);
1723          Discard_Junk_Node (P_Name);
1724
1725       elsif Token = Tok_Dot then
1726          Error_Msg_SC ("selected loop parameter not allowed");
1727          Restore_Scan_State (Scan_State);
1728          Discard_Junk_Node (P_Name);
1729       end if;
1730
1731       T_In;
1732
1733       if Token = Tok_Reverse then
1734          Scan; -- past REVERSE
1735          Set_Reverse_Present (Loop_Param_Specification_Node, True);
1736       end if;
1737
1738       Set_Discrete_Subtype_Definition
1739         (Loop_Param_Specification_Node, P_Discrete_Subtype_Definition);
1740       return Loop_Param_Specification_Node;
1741
1742    exception
1743       when Error_Resync =>
1744          return Error;
1745    end P_Loop_Parameter_Specification;
1746
1747    ----------------------------------
1748    -- 5.5.1 Iterator_Specification --
1749    ----------------------------------
1750
1751    function P_Iterator_Specification (Def_Id : Node_Id) return Node_Id is
1752       Node1 : Node_Id;
1753    begin
1754       Node1 :=  New_Node (N_Iterator_Specification, Token_Ptr);
1755       Set_Defining_Identifier (Node1, Def_Id);
1756
1757       if Token = Tok_Colon then
1758          Scan;  --  past :
1759          Set_Subtype_Indication (Node1, P_Subtype_Indication);
1760       end if;
1761
1762       if Token = Tok_Of then
1763          Set_Of_Present (Node1);
1764          Scan;  --  past OF
1765
1766       elsif Token = Tok_In then
1767          Scan;  --  past IN
1768
1769       else
1770          return Error;
1771       end if;
1772
1773       if Token = Tok_Reverse then
1774          Scan; -- past REVERSE
1775          Set_Reverse_Present (Node1, True);
1776       end if;
1777
1778       Set_Name (Node1, P_Name);
1779
1780       return Node1;
1781    end P_Iterator_Specification;
1782
1783    --------------------------
1784    -- 5.6  Block Statement --
1785    --------------------------
1786
1787    --  BLOCK_STATEMENT ::=
1788    --    [block_STATEMENT_IDENTIFIER:]
1789    --      [declare
1790    --        DECLARATIVE_PART]
1791    --      begin
1792    --        HANDLED_SEQUENCE_OF_STATEMENTS
1793    --      end [block_IDENTIFIER];
1794
1795    --  The parsing of block statements is handled by one of the two functions
1796    --  P_Declare_Statement or P_Begin_Statement depending on whether or not
1797    --  a declare section is present
1798
1799    --  P_Declare_Statement
1800
1801    --  This function parses a block statement with DECLARE present
1802
1803    --  The caller has checked that the initial token is DECLARE
1804
1805    --  Error recovery: cannot raise Error_Resync
1806
1807    function P_Declare_Statement
1808      (Block_Name : Node_Id := Empty)
1809       return       Node_Id
1810    is
1811       Block_Node   : Node_Id;
1812       Created_Name : Node_Id;
1813
1814    begin
1815       Block_Node := New_Node (N_Block_Statement, Token_Ptr);
1816
1817       Push_Scope_Stack;
1818       Scope.Table (Scope.Last).Etyp := E_Name;
1819       Scope.Table (Scope.Last).Lreq := Present (Block_Name);
1820       Scope.Table (Scope.Last).Ecol := Start_Column;
1821       Scope.Table (Scope.Last).Labl := Block_Name;
1822       Scope.Table (Scope.Last).Sloc := Token_Ptr;
1823
1824       Scan; -- past DECLARE
1825
1826       if No (Block_Name) then
1827          Created_Name :=
1828            Make_Identifier (Sloc (Block_Node),
1829              Chars => Set_Loop_Block_Name ('B'));
1830          Set_Comes_From_Source (Created_Name, False);
1831          Set_Has_Created_Identifier (Block_Node, True);
1832          Set_Identifier (Block_Node, Created_Name);
1833          Scope.Table (Scope.Last).Labl := Created_Name;
1834       else
1835          Set_Identifier (Block_Node, Block_Name);
1836       end if;
1837
1838       Append_Elmt (Block_Node, Label_List);
1839       Parse_Decls_Begin_End (Block_Node);
1840       return Block_Node;
1841    end P_Declare_Statement;
1842
1843    --  P_Begin_Statement
1844
1845    --  This function parses a block statement with no DECLARE present
1846
1847    --  The caller has checked that the initial token is BEGIN
1848
1849    --  Error recovery: cannot raise Error_Resync
1850
1851    function P_Begin_Statement
1852      (Block_Name : Node_Id := Empty)
1853       return       Node_Id
1854    is
1855       Block_Node   : Node_Id;
1856       Created_Name : Node_Id;
1857
1858    begin
1859       Block_Node := New_Node (N_Block_Statement, Token_Ptr);
1860
1861       Push_Scope_Stack;
1862       Scope.Table (Scope.Last).Etyp := E_Name;
1863       Scope.Table (Scope.Last).Lreq := Present (Block_Name);
1864       Scope.Table (Scope.Last).Ecol := Start_Column;
1865       Scope.Table (Scope.Last).Labl := Block_Name;
1866       Scope.Table (Scope.Last).Sloc := Token_Ptr;
1867
1868       if No (Block_Name) then
1869          Created_Name :=
1870            Make_Identifier (Sloc (Block_Node),
1871              Chars => Set_Loop_Block_Name ('B'));
1872          Set_Comes_From_Source (Created_Name, False);
1873          Set_Has_Created_Identifier (Block_Node, True);
1874          Set_Identifier (Block_Node, Created_Name);
1875          Scope.Table (Scope.Last).Labl := Created_Name;
1876       else
1877          Set_Identifier (Block_Node, Block_Name);
1878       end if;
1879
1880       Append_Elmt (Block_Node, Label_List);
1881
1882       Scope.Table (Scope.Last).Ecol := Start_Column;
1883       Scope.Table (Scope.Last).Sloc := Token_Ptr;
1884       Scan; -- past BEGIN
1885       Set_Handled_Statement_Sequence
1886         (Block_Node, P_Handled_Sequence_Of_Statements);
1887       End_Statements (Handled_Statement_Sequence (Block_Node));
1888       return Block_Node;
1889    end P_Begin_Statement;
1890
1891    -------------------------
1892    -- 5.7  Exit Statement --
1893    -------------------------
1894
1895    --  EXIT_STATEMENT ::=
1896    --    exit [loop_NAME] [when CONDITION];
1897
1898    --  The caller has checked that the initial token is EXIT
1899
1900    --  Error recovery: can raise Error_Resync
1901
1902    function P_Exit_Statement return Node_Id is
1903       Exit_Node : Node_Id;
1904
1905       function Missing_Semicolon_On_Exit return Boolean;
1906       --  This function deals with the following specialized situation
1907       --
1908       --    when 'x' =>
1909       --       exit [identifier]
1910       --    when 'y' =>
1911       --
1912       --  This looks like a messed up EXIT WHEN, when in fact the problem
1913       --  is a missing semicolon. It is called with Token pointing to the
1914       --  WHEN token, and returns True if a semicolon is missing before
1915       --  the WHEN as in the above example.
1916
1917       -------------------------------
1918       -- Missing_Semicolon_On_Exit --
1919       -------------------------------
1920
1921       function Missing_Semicolon_On_Exit return Boolean is
1922          State : Saved_Scan_State;
1923
1924       begin
1925          if not Token_Is_At_Start_Of_Line then
1926             return False;
1927
1928          elsif Scope.Table (Scope.Last).Etyp /= E_Case then
1929             return False;
1930
1931          else
1932             Save_Scan_State (State);
1933             Scan; -- past WHEN
1934             Scan; -- past token after WHEN
1935
1936             if Token = Tok_Arrow then
1937                Restore_Scan_State (State);
1938                return True;
1939             else
1940                Restore_Scan_State (State);
1941                return False;
1942             end if;
1943          end if;
1944       end Missing_Semicolon_On_Exit;
1945
1946    --  Start of processing for P_Exit_Statement
1947
1948    begin
1949       Exit_Node := New_Node (N_Exit_Statement, Token_Ptr);
1950       Scan; -- past EXIT
1951
1952       if Token = Tok_Identifier then
1953          Set_Name (Exit_Node, P_Qualified_Simple_Name);
1954
1955       elsif Style_Check then
1956          --  This EXIT has no name, so check that
1957          --  the innermost loop is unnamed too.
1958
1959          Check_No_Exit_Name :
1960          for J in reverse 1 .. Scope.Last loop
1961             if Scope.Table (J).Etyp = E_Loop then
1962                if Present (Scope.Table (J).Labl)
1963                  and then Comes_From_Source (Scope.Table (J).Labl)
1964                then
1965                   --  Innermost loop in fact had a name, style check fails
1966
1967                   Style.No_Exit_Name (Scope.Table (J).Labl);
1968                end if;
1969
1970                exit Check_No_Exit_Name;
1971             end if;
1972          end loop Check_No_Exit_Name;
1973       end if;
1974
1975       if Token = Tok_When and then not Missing_Semicolon_On_Exit then
1976          Scan; -- past WHEN
1977          Set_Condition (Exit_Node, P_Condition);
1978
1979       --  Allow IF instead of WHEN, giving error message
1980
1981       elsif Token = Tok_If then
1982          T_When;
1983          Scan; -- past IF used in place of WHEN
1984          Set_Condition (Exit_Node, P_Expression_No_Right_Paren);
1985       end if;
1986
1987       TF_Semicolon;
1988       return Exit_Node;
1989    end P_Exit_Statement;
1990
1991    -------------------------
1992    -- 5.8  Goto Statement --
1993    -------------------------
1994
1995    --  GOTO_STATEMENT ::= goto label_NAME;
1996
1997    --  The caller has checked that the initial token is GOTO  (or TO in the
1998    --  error case where GO and TO were incorrectly separated).
1999
2000    --  Error recovery: can raise Error_Resync
2001
2002    function P_Goto_Statement return Node_Id is
2003       Goto_Node : Node_Id;
2004
2005    begin
2006       Goto_Node := New_Node (N_Goto_Statement, Token_Ptr);
2007       Scan; -- past GOTO (or TO)
2008       Set_Name (Goto_Node, P_Qualified_Simple_Name_Resync);
2009       Append_Elmt (Goto_Node, Goto_List);
2010       No_Constraint;
2011       TF_Semicolon;
2012       return Goto_Node;
2013    end P_Goto_Statement;
2014
2015    ---------------------------
2016    -- Parse_Decls_Begin_End --
2017    ---------------------------
2018
2019    --  This function parses the construct:
2020
2021    --      DECLARATIVE_PART
2022    --    begin
2023    --      HANDLED_SEQUENCE_OF_STATEMENTS
2024    --    end [NAME];
2025
2026    --  The caller has built the scope stack entry, and created the node to
2027    --  whose Declarations and Handled_Statement_Sequence fields are to be
2028    --  set. On return these fields are filled in (except in the case of a
2029    --  task body, where the handled statement sequence is optional, and may
2030    --  thus be Empty), and the scan is positioned past the End sequence.
2031
2032    --  If the BEGIN is missing, then the parent node is used to help construct
2033    --  an appropriate missing BEGIN message. Possibilities for the parent are:
2034
2035    --    N_Block_Statement     declare block
2036    --    N_Entry_Body          entry body
2037    --    N_Package_Body        package body (begin part optional)
2038    --    N_Subprogram_Body     procedure or function body
2039    --    N_Task_Body           task body
2040
2041    --  Note: in the case of a block statement, there is definitely a DECLARE
2042    --  present (because a Begin statement without a DECLARE is handled by the
2043    --  P_Begin_Statement procedure, which does not call Parse_Decls_Begin_End.
2044
2045    --  Error recovery: cannot raise Error_Resync
2046
2047    procedure Parse_Decls_Begin_End (Parent : Node_Id) is
2048       Body_Decl    : Node_Id;
2049       Body_Sloc    : Source_Ptr;
2050       Decls        : List_Id;
2051       Decl         : Node_Id;
2052       Parent_Nkind : Node_Kind;
2053       Spec_Node    : Node_Id;
2054       HSS          : Node_Id;
2055
2056       procedure Missing_Begin (Msg : String);
2057       --  Called to post a missing begin message. In the normal case this is
2058       --  posted at the start of the current token. A special case arises when
2059       --  P_Declarative_Items has previously found a missing begin, in which
2060       --  case we replace the original error message.
2061
2062       procedure Set_Null_HSS (Parent : Node_Id);
2063       --  Construct an empty handled statement sequence and install in Parent
2064       --  Leaves HSS set to reference the newly constructed statement sequence.
2065
2066       -------------------
2067       -- Missing_Begin --
2068       -------------------
2069
2070       procedure Missing_Begin (Msg : String) is
2071       begin
2072          if Missing_Begin_Msg = No_Error_Msg then
2073             Error_Msg_BC (Msg);
2074          else
2075             Change_Error_Text (Missing_Begin_Msg, Msg);
2076
2077             --  Purge any messages issued after than, since a missing begin
2078             --  can cause a lot of havoc, and it is better not to dump these
2079             --  cascaded messages on the user.
2080
2081             Purge_Messages (Get_Location (Missing_Begin_Msg), Prev_Token_Ptr);
2082          end if;
2083       end Missing_Begin;
2084
2085       ------------------
2086       -- Set_Null_HSS --
2087       ------------------
2088
2089       procedure Set_Null_HSS (Parent : Node_Id) is
2090          Null_Stm : Node_Id;
2091
2092       begin
2093          Null_Stm :=
2094            Make_Null_Statement (Token_Ptr);
2095          Set_Comes_From_Source (Null_Stm, False);
2096
2097          HSS :=
2098            Make_Handled_Sequence_Of_Statements (Token_Ptr,
2099              Statements => New_List (Null_Stm));
2100          Set_Comes_From_Source (HSS, False);
2101
2102          Set_Handled_Statement_Sequence (Parent, HSS);
2103       end Set_Null_HSS;
2104
2105    --  Start of processing for Parse_Decls_Begin_End
2106
2107    begin
2108       Decls := P_Declarative_Part;
2109
2110       --  Check for misplacement of later vs basic declarations in Ada 83
2111
2112       if Ada_Version = Ada_83 then
2113          Decl := First (Decls);
2114
2115          --  Loop through sequence of basic declarative items
2116
2117          Outer : while Present (Decl) loop
2118             if Nkind (Decl) /= N_Subprogram_Body
2119               and then Nkind (Decl) /= N_Package_Body
2120               and then Nkind (Decl) /= N_Task_Body
2121               and then Nkind (Decl) not in  N_Body_Stub
2122             then
2123                Next (Decl);
2124
2125             --  Once a body is encountered, we only allow later declarative
2126             --  items. The inner loop checks the rest of the list.
2127
2128             else
2129                Body_Sloc := Sloc (Decl);
2130
2131                Inner : while Present (Decl) loop
2132                   if Nkind (Decl) not in N_Later_Decl_Item
2133                     and then Nkind (Decl) /= N_Pragma
2134                   then
2135                      if Ada_Version = Ada_83 then
2136                         Error_Msg_Sloc := Body_Sloc;
2137                         Error_Msg_N
2138                           ("(Ada 83) decl cannot appear after body#", Decl);
2139                      end if;
2140                   end if;
2141
2142                   Next (Decl);
2143                end loop Inner;
2144             end if;
2145          end loop Outer;
2146       end if;
2147
2148       --  Here is where we deal with the case of IS used instead of semicolon.
2149       --  Specifically, if the last declaration in the declarative part is a
2150       --  subprogram body still marked as having a bad IS, then this is where
2151       --  we decide that the IS should really have been a semicolon and that
2152       --  the body should have been a declaration. Note that if the bad IS
2153       --  had turned out to be OK (i.e. a decent begin/end was found for it),
2154       --  then the Bad_Is_Detected flag would have been reset by now.
2155
2156       Body_Decl := Last (Decls);
2157
2158       if Present (Body_Decl)
2159         and then Nkind (Body_Decl) = N_Subprogram_Body
2160         and then Bad_Is_Detected (Body_Decl)
2161       then
2162          --  OK, we have the case of a bad IS, so we need to fix up the tree.
2163          --  What we have now is a subprogram body with attached declarations
2164          --  and a possible statement sequence.
2165
2166          --  First step is to take the declarations that were part of the bogus
2167          --  subprogram body and append them to the outer declaration chain.
2168          --  In other words we append them past the body (which we will later
2169          --  convert into a declaration).
2170
2171          Append_List (Declarations (Body_Decl), Decls);
2172
2173          --  Now take the handled statement sequence of the bogus body and
2174          --  set it as the statement sequence for the outer construct. Note
2175          --  that it may be empty (we specially allowed a missing BEGIN for
2176          --  a subprogram body marked as having a bad IS -- see below).
2177
2178          Set_Handled_Statement_Sequence (Parent,
2179            Handled_Statement_Sequence (Body_Decl));
2180
2181          --  Next step is to convert the old body node to a declaration node
2182
2183          Spec_Node := Specification (Body_Decl);
2184          Change_Node (Body_Decl, N_Subprogram_Declaration);
2185          Set_Specification (Body_Decl, Spec_Node);
2186
2187          --  Final step is to put the declarations for the parent where
2188          --  they belong, and then fall through the IF to scan out the
2189          --  END statements.
2190
2191          Set_Declarations (Parent, Decls);
2192
2193       --  This is the normal case (i.e. any case except the bad IS case)
2194       --  If we have a BEGIN, then scan out the sequence of statements, and
2195       --  also reset the expected column for the END to match the BEGIN.
2196
2197       else
2198          Set_Declarations (Parent, Decls);
2199
2200          if Token = Tok_Begin then
2201             if Style_Check then
2202                Style.Check_Indentation;
2203             end if;
2204
2205             Error_Msg_Col := Scope.Table (Scope.Last).Ecol;
2206
2207             if RM_Column_Check
2208               and then Token_Is_At_Start_Of_Line
2209               and then Start_Column /= Error_Msg_Col
2210             then
2211                Error_Msg_SC ("(style) BEGIN in wrong column, should be@");
2212
2213             else
2214                Scope.Table (Scope.Last).Ecol := Start_Column;
2215             end if;
2216
2217             Scope.Table (Scope.Last).Sloc := Token_Ptr;
2218             Scan; -- past BEGIN
2219             Set_Handled_Statement_Sequence (Parent,
2220               P_Handled_Sequence_Of_Statements);
2221
2222          --  No BEGIN present
2223
2224          else
2225             Parent_Nkind := Nkind (Parent);
2226
2227             --  A special check for the missing IS case. If we have a
2228             --  subprogram body that was marked as having a suspicious
2229             --  IS, and the current token is END, then we simply confirm
2230             --  the suspicion, and do not require a BEGIN to be present
2231
2232             if Parent_Nkind = N_Subprogram_Body
2233               and then Token  = Tok_End
2234               and then Scope.Table (Scope.Last).Etyp = E_Suspicious_Is
2235             then
2236                Scope.Table (Scope.Last).Etyp := E_Bad_Is;
2237
2238             --  Otherwise BEGIN is not required for a package body, so we
2239             --  don't mind if it is missing, but we do construct a dummy
2240             --  one (so that we have somewhere to set End_Label).
2241
2242             --  However if we have something other than a BEGIN which
2243             --  looks like it might be statements, then we signal a missing
2244             --  BEGIN for these cases as well. We define "something which
2245             --  looks like it might be statements" as a token other than
2246             --  END, EOF, or a token which starts declarations.
2247
2248             elsif Parent_Nkind = N_Package_Body
2249               and then (Token = Tok_End
2250                           or else Token = Tok_EOF
2251                           or else Token in Token_Class_Declk)
2252             then
2253                Set_Null_HSS (Parent);
2254
2255             --  These are cases in which a BEGIN is required and not present
2256
2257             else
2258                Set_Null_HSS (Parent);
2259
2260                --  Prepare to issue error message
2261
2262                Error_Msg_Sloc := Scope.Table (Scope.Last).Sloc;
2263                Error_Msg_Node_1 := Scope.Table (Scope.Last).Labl;
2264
2265                --  Now issue appropriate message
2266
2267                if Parent_Nkind = N_Block_Statement then
2268                   Missing_Begin ("missing BEGIN for DECLARE#!");
2269
2270                elsif Parent_Nkind = N_Entry_Body then
2271                   Missing_Begin ("missing BEGIN for ENTRY#!");
2272
2273                elsif Parent_Nkind = N_Subprogram_Body then
2274                   if Nkind (Specification (Parent))
2275                                = N_Function_Specification
2276                   then
2277                      Missing_Begin ("missing BEGIN for function&#!");
2278                   else
2279                      Missing_Begin ("missing BEGIN for procedure&#!");
2280                   end if;
2281
2282                --  The case for package body arises only when
2283                --  we have possible statement junk present.
2284
2285                elsif Parent_Nkind = N_Package_Body then
2286                   Missing_Begin ("missing BEGIN for package body&#!");
2287
2288                else
2289                   pragma Assert (Parent_Nkind = N_Task_Body);
2290                   Missing_Begin ("missing BEGIN for task body&#!");
2291                end if;
2292
2293                --  Here we pick up the statements after the BEGIN that
2294                --  should have been present but was not. We don't insist
2295                --  on statements being present if P_Declarative_Part had
2296                --  already found a missing BEGIN, since it might have
2297                --  swallowed a lone statement into the declarative part.
2298
2299                if Missing_Begin_Msg /= No_Error_Msg
2300                  and then Token = Tok_End
2301                then
2302                   null;
2303                else
2304                   Set_Handled_Statement_Sequence (Parent,
2305                     P_Handled_Sequence_Of_Statements);
2306                end if;
2307             end if;
2308          end if;
2309       end if;
2310
2311       --  Here with declarations and handled statement sequence scanned
2312
2313       if Present (Handled_Statement_Sequence (Parent)) then
2314          End_Statements (Handled_Statement_Sequence (Parent));
2315       else
2316          End_Statements;
2317       end if;
2318
2319       --  We know that End_Statements removed an entry from the scope stack
2320       --  (because it is required to do so under all circumstances). We can
2321       --  therefore reference the entry it removed one past the stack top.
2322       --  What we are interested in is whether it was a case of a bad IS.
2323
2324       if Scope.Table (Scope.Last + 1).Etyp = E_Bad_Is then
2325          Error_Msg -- CODEFIX
2326            ("|IS should be "";""", Scope.Table (Scope.Last + 1).S_Is);
2327          Set_Bad_Is_Detected (Parent, True);
2328       end if;
2329
2330    end Parse_Decls_Begin_End;
2331
2332    -------------------------
2333    -- Set_Loop_Block_Name --
2334    -------------------------
2335
2336    function Set_Loop_Block_Name (L : Character) return Name_Id is
2337    begin
2338       Name_Buffer (1) := L;
2339       Name_Buffer (2) := '_';
2340       Name_Len := 2;
2341       Loop_Block_Count := Loop_Block_Count + 1;
2342       Add_Nat_To_Name_Buffer (Loop_Block_Count);
2343       return Name_Find;
2344    end Set_Loop_Block_Name;
2345
2346    ---------------
2347    -- Then_Scan --
2348    ---------------
2349
2350    procedure Then_Scan is
2351    begin
2352       TF_Then;
2353
2354       while Token = Tok_Then loop
2355          Error_Msg_SC -- CODEFIX
2356            ("redundant THEN");
2357          TF_Then;
2358       end loop;
2359
2360       if Token = Tok_And or else Token = Tok_Or then
2361          Error_Msg_SC ("unexpected logical operator");
2362          Scan; -- past logical operator
2363
2364          if (Prev_Token = Tok_And and then Token = Tok_Then)
2365               or else
2366             (Prev_Token = Tok_Or  and then Token = Tok_Else)
2367          then
2368             Scan;
2369          end if;
2370
2371          Discard_Junk_Node (P_Expression);
2372       end if;
2373
2374       if Token = Tok_Then then
2375          Scan;
2376       end if;
2377    end Then_Scan;
2378
2379 end Ch5;