1 ------------------------------------------------------------------------------
3 -- GNAT COMPILER COMPONENTS --
9 -- Copyright (C) 1992-2022, Free Software Foundation, Inc. --
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. --
21 -- GNAT was originally developed by the GNAT team at New York University. --
22 -- Extensive contributions were provided by Ada Core Technologies Inc. --
24 ------------------------------------------------------------------------------
26 -- Token scan routines
28 -- Error recovery: none of the T_xxx or TF_xxx routines raise Error_Resync
33 type Position
is (SC
, BC
, AP
);
34 -- Specify position of error message (see Error_Msg_SC/BC/AP)
36 -----------------------
37 -- Local Subprograms --
38 -----------------------
40 procedure Check_Token
(T
: Token_Type
; P
: Position
);
41 pragma Inline
(Check_Token
);
42 -- Called by T_xx routines to check for reserved keyword token. P is the
43 -- position of the error message if the token is missing (see Wrong_Token)
45 procedure Wrong_Token
(T
: Token_Type
; P
: Position
);
46 -- Called when scanning a reserved keyword when the keyword is not present.
47 -- T is the token type for the keyword, and P indicates the position to be
48 -- used to place a message relative to the current token if the keyword is
49 -- not located nearby.
55 procedure Check_Token
(T
: Token_Type
; P
: Position
) is
71 Check_Token
(Tok_Abort
, SC
);
80 if Token
= Tok_Arrow
then
83 -- A little recovery helper, accept then in place of =>
85 elsif Token
= Tok_Then
then
86 Error_Msg_BC
-- CODEFIX
87 ("|THEN should be ""='>""");
88 Scan
; -- past THEN used in place of =>
90 elsif Token
= Tok_Colon_Equal
then
91 Error_Msg_SC
-- CODEFIX
92 ("|"":="" should be ""='>""");
93 Scan
; -- past := used in place of =>
96 Error_Msg_AP
-- CODEFIX
107 Check_Token
(Tok_At
, SC
);
116 Check_Token
(Tok_Body
, BC
);
125 if Token
= Tok_Box
then
128 Error_Msg_AP
-- CODEFIX
129 ("missing ""'<'>""");
139 if Token
= Tok_Colon
then
142 Error_Msg_AP
-- CODEFIX
151 procedure T_Colon_Equal
is
153 if Token
= Tok_Colon_Equal
then
156 elsif Token
= Tok_Equal
then
157 Error_Msg_SC
-- CODEFIX
158 ("|""="" should be "":=""");
161 elsif Token
= Tok_Colon
then
162 Error_Msg_SC
-- CODEFIX
163 ("|"":"" should be "":=""");
166 elsif Token
= Tok_Is
then
167 Error_Msg_SC
-- CODEFIX
168 ("|IS should be "":=""");
172 Error_Msg_AP
-- CODEFIX
183 if Token
= Tok_Comma
then
187 if Token
= Tok_Pragma
then
191 if Token
= Tok_Comma
then
194 Error_Msg_AP
-- CODEFIX
199 if Token
= Tok_Pragma
then
208 procedure T_Dot_Dot
is
210 if Token
= Tok_Dot_Dot
then
213 Error_Msg_AP
-- CODEFIX
224 Check_Token
(Tok_For
, AP
);
227 -----------------------
228 -- T_Greater_Greater --
229 -----------------------
231 procedure T_Greater_Greater
is
233 if Token
= Tok_Greater_Greater
then
236 Error_Msg_AP
-- CODEFIX
237 ("missing ""'>'>""");
239 end T_Greater_Greater
;
245 procedure T_Identifier
is
247 if Token
= Tok_Identifier
then
249 elsif Token
in Token_Class_Literal
then
250 Error_Msg_SC
("identifier expected");
253 Error_Msg_AP
("identifier expected");
263 Check_Token
(Tok_In
, AP
);
272 Ignore
(Tok_Semicolon
);
274 -- If we have IS scan past it
276 if Token
= Tok_Is
then
279 -- And ignore any following semicolons
281 Ignore
(Tok_Semicolon
);
283 -- Allow OF, => or = to substitute for IS with complaint
285 elsif Token
= Tok_Arrow
then
286 Error_Msg_SC
-- CODEFIX
287 ("|""=>"" should be IS");
290 elsif Token
= Tok_Of
then
291 Error_Msg_SC
-- CODEFIX
292 ("|OF should be IS");
295 elsif Token
= Tok_Equal
then
296 Error_Msg_SC
-- CODEFIX
297 ("|""="" should be IS");
301 Wrong_Token
(Tok_Is
, AP
);
304 -- Ignore extra IS keywords
306 while Token
= Tok_Is
loop
307 Error_Msg_SC
-- CODEFIX
308 ("|extra IS ignored");
317 procedure T_Left_Paren
is
319 if Token
= Tok_Left_Paren
then
322 Error_Msg_AP
-- CODEFIX
333 if Token
= Tok_Do
then
334 Error_Msg_SC
-- CODEFIX
338 Check_Token
(Tok_Loop
, AP
);
348 Check_Token
(Tok_Mod
, AP
);
357 Check_Token
(Tok_New
, AP
);
366 Check_Token
(Tok_Of
, AP
);
375 Check_Token
(Tok_Or
, AP
);
382 procedure T_Private
is
384 Check_Token
(Tok_Private
, SC
);
393 Check_Token
(Tok_Range
, AP
);
400 procedure T_Record
is
402 Check_Token
(Tok_Record
, AP
);
405 ---------------------
406 -- T_Right_Bracket --
407 ---------------------
409 procedure T_Right_Bracket
is
411 if Token
= Tok_Right_Bracket
then
414 Error_Msg_AP
-- CODEFIX
415 ("|missing ""']'""");
423 procedure T_Right_Paren
is
425 if Token
= Tok_Right_Paren
then
428 Error_Msg_AP
-- CODEFIX
437 procedure T_Semicolon
is
439 if Token
= Tok_Semicolon
then
442 if Token
= Tok_Semicolon
then
443 Error_Msg_SC
-- CODEFIX
444 ("|extra "";"" ignored");
450 elsif Token
= Tok_Colon
then
451 Error_Msg_SC
-- CODEFIX
452 ("|"":"" should be "";""");
456 elsif Token
= Tok_Comma
then
457 Error_Msg_SC
-- CODEFIX
458 ("|"","" should be "";""");
462 elsif Token
= Tok_Dot
then
463 Error_Msg_SC
-- CODEFIX
464 ("|""."" should be "";""");
468 -- An interesting little case. If the previous token is a semicolon,
469 -- then there is no way that we can legitimately need another semicolon.
470 -- This could only arise in an situation where an error has already been
471 -- signalled. By simply ignoring the request for a semicolon in this
472 -- case, we avoid some spurious missing semicolon messages.
474 elsif Prev_Token
= Tok_Semicolon
then
477 -- If the current token is | then this is a reasonable place to suggest
478 -- the possibility of a "C" confusion.
480 elsif Token
= Tok_Vertical_Bar
then
481 Error_Msg_SC
-- CODEFIX
482 ("unexpected occurrence of ""'|"", did you mean OR'?");
483 Resync_Past_Semicolon
;
486 -- Deal with pragma. If pragma is not at start of line, it is considered
487 -- misplaced otherwise we treat it as a normal missing semicolon case.
489 elsif Token
= Tok_Pragma
and then not Token_Is_At_Start_Of_Line
then
492 if Token
= Tok_Semicolon
then
498 -- If none of those tests return, we really have a missing semicolon
500 Error_Msg_AP
-- CODEFIX
511 Check_Token
(Tok_Then
, AP
);
520 Check_Token
(Tok_Type
, BC
);
529 Check_Token
(Tok_Use
, SC
);
538 Check_Token
(Tok_When
, SC
);
547 Check_Token
(Tok_With
, BC
);
554 procedure TF_Arrow
is
555 Scan_State
: Saved_Scan_State
;
558 if Token
= Tok_Arrow
then
559 Scan
; -- skip arrow and we are done
561 elsif Token
= Tok_Colon_Equal
then
562 T_Arrow
; -- Let T_Arrow give the message
565 T_Arrow
; -- give missing arrow message
566 Save_Scan_State
(Scan_State
); -- at start of junk tokens
569 if Prev_Token_Ptr
< Current_Line_Start
570 or else Token
= Tok_Semicolon
571 or else Token
= Tok_EOF
573 Restore_Scan_State
(Scan_State
); -- to where we were
577 Scan
; -- continue search
579 if Token
= Tok_Arrow
then
592 Scan_State
: Saved_Scan_State
;
595 if Token
= Tok_Is
then
596 T_Is
; -- past IS and we are done
598 -- Allow OF or => or = in place of IS (with error message)
601 or else Token
= Tok_Arrow
602 or else Token
= Tok_Equal
604 T_Is
; -- give missing IS message and skip bad token
607 T_Is
; -- give missing IS message
608 Save_Scan_State
(Scan_State
); -- at start of junk tokens
611 if Prev_Token_Ptr
< Current_Line_Start
612 or else Token
= Tok_Semicolon
613 or else Token
= Tok_EOF
615 Restore_Scan_State
(Scan_State
); -- to where we were
619 Scan
; -- continue search
622 or else Token
= Tok_Of
623 or else Token
= Tok_Arrow
625 Scan
; -- past IS or OF or =>
637 Scan_State
: Saved_Scan_State
;
640 if Token
= Tok_Loop
then
641 Scan
; -- past LOOP and we are done
643 -- Allow DO or THEN in place of LOOP
645 elsif Token
= Tok_Then
or else Token
= Tok_Do
then
646 T_Loop
; -- give missing LOOP message
649 T_Loop
; -- give missing LOOP message
650 Save_Scan_State
(Scan_State
); -- at start of junk tokens
653 if Prev_Token_Ptr
< Current_Line_Start
654 or else Token
= Tok_Semicolon
655 or else Token
= Tok_EOF
657 Restore_Scan_State
(Scan_State
); -- to where we were
661 Scan
; -- continue search
663 if Token
= Tok_Loop
or else Token
= Tok_Then
then
664 Scan
; -- past loop or then (message already generated)
675 procedure TF_Return
is
676 Scan_State
: Saved_Scan_State
;
679 if Token
= Tok_Return
then
680 Scan
; -- skip RETURN and we are done
683 Error_Msg_SC
-- CODEFIX
685 Save_Scan_State
(Scan_State
); -- at start of junk tokens
688 if Prev_Token_Ptr
< Current_Line_Start
689 or else Token
= Tok_Semicolon
690 or else Token
= Tok_EOF
692 Restore_Scan_State
(Scan_State
); -- to where we were
696 Scan
; -- continue search
698 if Token
= Tok_Return
then
710 procedure TF_Semicolon
is
711 Scan_State
: Saved_Scan_State
;
714 if Token
= Tok_Semicolon
then
718 -- An interesting little test here. If the previous token is a
719 -- semicolon, then there is no way that we can legitimately need
720 -- another semicolon. This could only arise in an error situation
721 -- where an error has already been signalled. By simply ignoring
722 -- the request for a semicolon in this case, we avoid some spurious
723 -- missing semicolon messages.
725 elsif Prev_Token
= Tok_Semicolon
then
729 -- Deal with pragma. If pragma is not at start of line, it is
730 -- considered misplaced otherwise we treat it as a normal
731 -- missing semicolon case.
733 if Token
= Tok_Pragma
734 and then not Token_Is_At_Start_Of_Line
738 if Token
= Tok_Semicolon
then
744 -- Here we definitely have a missing semicolon, so give message
748 -- Scan out junk on rest of line. Scan stops on END keyword, since
749 -- that seems to help avoid cascaded errors.
751 Save_Scan_State
(Scan_State
); -- at start of junk tokens
754 if Prev_Token_Ptr
< Current_Line_Start
755 or else Token
= Tok_EOF
756 or else Token
= Tok_End
758 Restore_Scan_State
(Scan_State
); -- to where we were
762 Scan
; -- continue search
764 if Token
= Tok_Semicolon
then
768 elsif Token
in Token_Class_After_SM
then
780 Scan_State
: Saved_Scan_State
;
783 if Token
= Tok_Then
then
784 Scan
; -- past THEN and we are done
787 T_Then
; -- give missing THEN message
788 Save_Scan_State
(Scan_State
); -- at start of junk tokens
791 if Prev_Token_Ptr
< Current_Line_Start
792 or else Token
= Tok_Semicolon
793 or else Token
= Tok_EOF
795 Restore_Scan_State
(Scan_State
); -- to where we were
799 Scan
; -- continue search
801 if Token
= Tok_Then
then
814 Scan_State
: Saved_Scan_State
;
817 if Token
= Tok_Use
then
818 Scan
; -- past USE and we are done
821 T_Use
; -- give USE expected message
822 Save_Scan_State
(Scan_State
); -- at start of junk tokens
825 if Prev_Token_Ptr
< Current_Line_Start
826 or else Token
= Tok_Semicolon
827 or else Token
= Tok_EOF
829 Restore_Scan_State
(Scan_State
); -- to where we were
833 Scan
; -- continue search
835 if Token
= Tok_Use
then
847 procedure U_Left_Paren
is
849 if Token
= Tok_Left_Paren
then
852 Error_Msg_AP
-- CODEFIX
861 procedure U_Right_Paren
is
863 if Token
= Tok_Right_Paren
then
866 Error_Msg_AP
-- CODEFIX
875 procedure Wrong_Token
(T
: Token_Type
; P
: Position
) is
876 Missing
: constant String := "missing ";
877 Image
: constant String := Token_Type
'Image (T
);
878 Tok_Name
: constant String := Image
(5 .. Image
'Length);
879 M
: constant String := Missing
& Tok_Name
;
882 if Token
= Tok_Semicolon
then
886 Error_Msg_SP
-- CODEFIX
887 ("|extra "";"" ignored");
893 elsif Token
= Tok_Comma
then
897 Error_Msg_SP
-- CODEFIX
898 ("|extra "","" ignored");
907 when SC
=> Error_Msg_SC
(M
);
908 when BC
=> Error_Msg_BC
(M
);
909 when AP
=> Error_Msg_AP
(M
);