1 ------------------------------------------------------------------------------
3 -- GNAT COMPILER COMPONENTS --
9 -- Copyright (C) 1992-2012, 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 pragma Style_Checks
(All_Checks
);
27 -- Turn off subprogram body ordering check. Subprograms are in order
28 -- by RM section rather than alphabetical
30 with Sinfo
.CN
; use Sinfo
.CN
;
35 -- Local subprograms, used only in this chapter
37 function P_Defining_Designator
return Node_Id
;
38 function P_Defining_Operator_Symbol
return Node_Id
;
39 function P_Return_Object_Declaration
return Node_Id
;
41 procedure P_Return_Subtype_Indication
(Decl_Node
: Node_Id
);
42 -- Decl_Node is a N_Object_Declaration. Set the Null_Exclusion_Present and
43 -- Object_Definition fields of Decl_Node.
45 procedure Check_Junk_Semicolon_Before_Return
;
46 -- Check for common error of junk semicolon before RETURN keyword of
47 -- function specification. If present, skip over it with appropriate error
48 -- message, leaving Scan_Ptr pointing to the RETURN after. This routine
49 -- also deals with a possibly misspelled version of Return.
51 procedure No_Constraint_Maybe_Expr_Func
;
52 -- Called after scanning return subtype to check for missing constraint,
53 -- taking into account the possibility of an occurrence of an expression
54 -- function where the IS has been forgotten.
56 ----------------------------------------
57 -- Check_Junk_Semicolon_Before_Return --
58 ----------------------------------------
60 procedure Check_Junk_Semicolon_Before_Return
is
61 Scan_State
: Saved_Scan_State
;
64 if Token
= Tok_Semicolon
then
65 Save_Scan_State
(Scan_State
);
66 Scan
; -- past the semicolon
68 if Token
= Tok_Return
then
69 Restore_Scan_State
(Scan_State
);
70 Error_Msg_SC
-- CODEFIX
71 ("|extra "";"" ignored");
72 Scan
; -- rescan past junk semicolon
74 Restore_Scan_State
(Scan_State
);
77 elsif Bad_Spelling_Of
(Tok_Return
) then
80 end Check_Junk_Semicolon_Before_Return
;
82 -----------------------------------
83 -- No_Constraint_Maybe_Expr_Func --
84 -----------------------------------
86 procedure No_Constraint_Maybe_Expr_Func
is
88 -- If we have a left paren at the start of the line, then assume this is
89 -- the case of an expression function with missing IS. We do not have to
90 -- diagnose the missing IS, that is done elsewhere. We do this game in
91 -- Ada 2012 mode where expression functions are legal.
93 if Token
= Tok_Left_Paren
94 and Ada_Version
>= Ada_2012
95 and Token_Is_At_Start_Of_Line
97 -- One exception if we have "(token .." then this is a constraint
100 Scan_State
: Saved_Scan_State
;
103 Save_Scan_State
(Scan_State
);
104 Scan
; -- past left paren
105 Scan
; -- past following token
107 -- If we have "(token .." then restore scan state and treat as
108 -- unexpected constraint.
110 if Token
= Tok_Dot_Dot
then
111 Restore_Scan_State
(Scan_State
);
114 -- Otherwise we treat this as an expression function
117 Restore_Scan_State
(Scan_State
);
121 -- Otherwise use standard routine to check for no constraint present
126 end No_Constraint_Maybe_Expr_Func
;
128 -----------------------------------------------------
129 -- 6.1 Subprogram (Also 6.3, 8.5.4, 10.1.3, 12.3) --
130 -----------------------------------------------------
132 -- This routine scans out a subprogram declaration, subprogram body,
133 -- subprogram renaming declaration or subprogram generic instantiation.
134 -- It also handles the new Ada 2012 expression function form
136 -- SUBPROGRAM_DECLARATION ::=
137 -- SUBPROGRAM_SPECIFICATION
138 -- [ASPECT_SPECIFICATIONS];
140 -- ABSTRACT_SUBPROGRAM_DECLARATION ::=
141 -- SUBPROGRAM_SPECIFICATION is abstract
142 -- [ASPECT_SPECIFICATIONS];
144 -- SUBPROGRAM_SPECIFICATION ::=
145 -- procedure DEFINING_PROGRAM_UNIT_NAME PARAMETER_PROFILE
146 -- | function DEFINING_DESIGNATOR PARAMETER_AND_RESULT_PROFILE
148 -- PARAMETER_PROFILE ::= [FORMAL_PART]
150 -- PARAMETER_AND_RESULT_PROFILE ::= [FORMAL_PART] return SUBTYPE_MARK
152 -- SUBPROGRAM_BODY ::=
153 -- SUBPROGRAM_SPECIFICATION is
156 -- HANDLED_SEQUENCE_OF_STATEMENTS
159 -- SUBPROGRAM_RENAMING_DECLARATION ::=
160 -- SUBPROGRAM_SPECIFICATION renames callable_entity_NAME
161 -- [ASPECT_SPECIFICATIONS];
163 -- SUBPROGRAM_BODY_STUB ::=
164 -- SUBPROGRAM_SPECIFICATION is separate;
166 -- GENERIC_INSTANTIATION ::=
167 -- procedure DEFINING_PROGRAM_UNIT_NAME is
168 -- new generic_procedure_NAME [GENERIC_ACTUAL_PART];
169 -- | function DEFINING_DESIGNATOR is
170 -- new generic_function_NAME [GENERIC_ACTUAL_PART];
172 -- NULL_PROCEDURE_DECLARATION ::=
173 -- SUBPROGRAM_SPECIFICATION is null;
175 -- Null procedures are an Ada 2005 feature. A null procedure declaration
176 -- is classified as a basic declarative item, but it is parsed here, with
177 -- other subprogram constructs.
179 -- EXPRESSION_FUNCTION ::=
180 -- FUNCTION SPECIFICATION IS (EXPRESSION)
181 -- [ASPECT_SPECIFICATIONS];
183 -- The value in Pf_Flags indicates which of these possible declarations
184 -- is acceptable to the caller:
186 -- Pf_Flags.Decl Set if declaration OK
187 -- Pf_Flags.Gins Set if generic instantiation OK
188 -- Pf_Flags.Pbod Set if proper body OK
189 -- Pf_Flags.Rnam Set if renaming declaration OK
190 -- Pf_Flags.Stub Set if body stub OK
191 -- Pf_Flags.Pexp Set if expression function OK
193 -- If an inappropriate form is encountered, it is scanned out but an
194 -- error message indicating that it is appearing in an inappropriate
195 -- context is issued. The only possible values for Pf_Flags are those
196 -- defined as constants in the Par package.
198 -- The caller has checked that the initial token is FUNCTION, PROCEDURE,
199 -- NOT or OVERRIDING.
201 -- Error recovery: cannot raise Error_Resync
203 function P_Subprogram
(Pf_Flags
: Pf_Rec
) return Node_Id
is
204 Specification_Node
: Node_Id
;
207 Fpart_List
: List_Id
;
208 Fpart_Sloc
: Source_Ptr
;
209 Result_Not_Null
: Boolean := False;
210 Result_Node
: Node_Id
;
214 Rename_Node
: Node_Id
;
215 Absdec_Node
: Node_Id
;
217 Fproc_Sloc
: Source_Ptr
;
219 Scan_State
: Saved_Scan_State
;
221 -- Flags for optional overriding indication. Two flags are needed,
222 -- to distinguish positive and negative overriding indicators from
223 -- the absence of any indicator.
225 Is_Overriding
: Boolean := False;
226 Not_Overriding
: Boolean := False;
229 -- Set up scope stack entry. Note that the Labl field will be set later
231 SIS_Entry_Active
:= False;
232 SIS_Missing_Semicolon_Message
:= No_Error_Msg
;
234 Scope
.Table
(Scope
.Last
).Sloc
:= Token_Ptr
;
235 Scope
.Table
(Scope
.Last
).Etyp
:= E_Name
;
236 Scope
.Table
(Scope
.Last
).Ecol
:= Start_Column
;
237 Scope
.Table
(Scope
.Last
).Lreq
:= False;
239 Aspects
:= Empty_List
;
241 -- Ada 2005: Scan leading NOT OVERRIDING indicator
243 if Token
= Tok_Not
then
246 if Token
= Tok_Overriding
then
247 Scan
; -- past OVERRIDING
248 Not_Overriding
:= True;
250 -- Overriding keyword used in non Ada 2005 mode
252 elsif Token
= Tok_Identifier
253 and then Token_Name
= Name_Overriding
255 Error_Msg_SC
("overriding indicator is an Ada 2005 extension");
256 Error_Msg_SC
("\unit must be compiled with -gnat05 switch");
257 Scan
; -- past Overriding
258 Not_Overriding
:= True;
261 Error_Msg_SC
-- CODEFIX
262 ("OVERRIDING expected!");
265 -- Ada 2005: scan leading OVERRIDING indicator
267 -- Note: in the case of OVERRIDING keyword used in Ada 95 mode, the
268 -- declaration circuit already gave an error message and changed the
269 -- token to Tok_Overriding.
271 elsif Token
= Tok_Overriding
then
272 Scan
; -- past OVERRIDING
273 Is_Overriding
:= True;
276 if Is_Overriding
or else Not_Overriding
then
278 -- Note that if we are not in Ada_2005 mode, error messages have
279 -- already been given, so no need to give another message here.
281 -- An overriding indicator is allowed for subprogram declarations,
282 -- bodies (including subunits), renamings, stubs, and instantiations.
283 -- The test against Pf_Decl_Pbod is added to account for the case of
284 -- subprograms declared in a protected type, where only subprogram
285 -- declarations and bodies can occur. The Pf_Pbod case is for
288 if Pf_Flags
/= Pf_Decl_Gins_Pbod_Rnam_Stub_Pexp
290 Pf_Flags
/= Pf_Decl_Pbod_Pexp
292 Pf_Flags
/= Pf_Pbod_Pexp
294 Error_Msg_SC
("overriding indicator not allowed here!");
296 elsif Token
/= Tok_Function
and then Token
/= Tok_Procedure
then
297 Error_Msg_SC
-- CODEFIX
298 ("FUNCTION or PROCEDURE expected!");
302 Func
:= (Token
= Tok_Function
);
303 Fproc_Sloc
:= Token_Ptr
;
304 Scan
; -- past FUNCTION or PROCEDURE
309 Name_Node
:= P_Defining_Designator
;
311 if Nkind
(Name_Node
) = N_Defining_Operator_Symbol
312 and then Scope
.Last
= 1
314 Error_Msg_SP
("operator symbol not allowed at library level");
315 Name_Node
:= New_Entity
(N_Defining_Identifier
, Sloc
(Name_Node
));
317 -- Set name from file name, we need some junk name, and that's
318 -- as good as anything. This is only approximate, since we do
319 -- not do anything with non-standard name translations.
321 Get_Name_String
(File_Name
(Current_Source_File
));
323 for J
in 1 .. Name_Len
loop
324 if Name_Buffer
(J
) = '.' then
330 Set_Chars
(Name_Node
, Name_Find
);
331 Set_Error_Posted
(Name_Node
);
335 Name_Node
:= P_Defining_Program_Unit_Name
;
338 Scope
.Table
(Scope
.Last
).Labl
:= Name_Node
;
341 -- Deal with generic instantiation, the one case in which we do not
342 -- have a subprogram specification as part of whatever we are parsing
344 if Token
= Tok_Is
then
345 Save_Scan_State
(Scan_State
); -- at the IS
346 T_Is
; -- checks for redundant IS
348 if Token
= Tok_New
then
349 if not Pf_Flags
.Gins
then
350 Error_Msg_SC
("generic instantiation not allowed here!");
356 Inst_Node
:= New_Node
(N_Function_Instantiation
, Fproc_Sloc
);
357 Set_Name
(Inst_Node
, P_Function_Name
);
359 Inst_Node
:= New_Node
(N_Procedure_Instantiation
, Fproc_Sloc
);
360 Set_Name
(Inst_Node
, P_Qualified_Simple_Name
);
363 Set_Defining_Unit_Name
(Inst_Node
, Name_Node
);
364 Set_Generic_Associations
(Inst_Node
, P_Generic_Actual_Part_Opt
);
365 P_Aspect_Specifications
(Inst_Node
);
366 Pop_Scope_Stack
; -- Don't need scope stack entry in this case
368 if Is_Overriding
then
369 Set_Must_Override
(Inst_Node
);
371 elsif Not_Overriding
then
372 Set_Must_Not_Override
(Inst_Node
);
378 Restore_Scan_State
(Scan_State
); -- to the IS
382 -- If not a generic instantiation, then we definitely have a subprogram
383 -- specification (all possibilities at this stage include one here)
385 Fpart_Sloc
:= Token_Ptr
;
387 Check_Misspelling_Of
(Tok_Return
);
389 -- Scan formal part. First a special error check. If we have an
390 -- identifier here, then we have a definite error. If this identifier
391 -- is on the same line as the designator, then we assume it is the
392 -- first formal after a missing left parenthesis
394 if Token
= Tok_Identifier
395 and then not Token_Is_At_Start_Of_Line
397 T_Left_Paren
; -- to generate message
398 Fpart_List
:= P_Formal_Part
;
400 -- Otherwise scan out an optional formal part in the usual manner
403 Fpart_List
:= P_Parameter_Profile
;
406 -- We treat what we have as a function specification if FUNCTION was
407 -- used, or if a RETURN is present. This gives better error recovery
408 -- since later RETURN statements will be valid in either case.
410 Check_Junk_Semicolon_Before_Return
;
411 Result_Node
:= Error
;
413 if Token
= Tok_Return
then
416 ("PROCEDURE should be FUNCTION", Fproc_Sloc
);
422 Result_Not_Null
:= P_Null_Exclusion
; -- Ada 2005 (AI-231)
424 -- Ada 2005 (AI-318-02)
426 if Token
= Tok_Access
then
427 if Ada_Version
< Ada_2005
then
429 ("anonymous access result type is an Ada 2005 extension");
430 Error_Msg_SC
("\unit must be compiled with -gnat05 switch");
433 Result_Node
:= P_Access_Definition
(Result_Not_Null
);
436 Result_Node
:= P_Subtype_Mark
;
437 No_Constraint_Maybe_Expr_Func
;
441 -- Skip extra parenthesis at end of formal part
443 Ignore
(Tok_Right_Paren
);
445 -- For function, scan result subtype
450 if Prev_Token
= Tok_Return
then
451 Result_Node
:= P_Subtype_Mark
;
457 Specification_Node
:=
458 New_Node
(N_Function_Specification
, Fproc_Sloc
);
460 Set_Null_Exclusion_Present
(Specification_Node
, Result_Not_Null
);
461 Set_Result_Definition
(Specification_Node
, Result_Node
);
464 Specification_Node
:=
465 New_Node
(N_Procedure_Specification
, Fproc_Sloc
);
468 Set_Defining_Unit_Name
(Specification_Node
, Name_Node
);
469 Set_Parameter_Specifications
(Specification_Node
, Fpart_List
);
471 if Is_Overriding
then
472 Set_Must_Override
(Specification_Node
);
474 elsif Not_Overriding
then
475 Set_Must_Not_Override
(Specification_Node
);
478 -- Error check: barriers not allowed on protected functions/procedures
480 if Token
= Tok_When
then
482 Error_Msg_SC
("barrier not allowed on function, only on entry");
484 Error_Msg_SC
("barrier not allowed on procedure, only on entry");
488 Discard_Junk_Node
(P_Expression
);
491 -- Deal with semicolon followed by IS. We want to treat this as IS
493 if Token
= Tok_Semicolon
then
494 Save_Scan_State
(Scan_State
);
495 Scan
; -- past semicolon
497 if Token
= Tok_Is
then
498 Error_Msg_SP
-- CODEFIX
499 ("extra "";"" ignored");
501 Restore_Scan_State
(Scan_State
);
505 -- Subprogram declaration ended by aspect specifications
507 if Aspect_Specifications_Present
then
508 goto Subprogram_Declaration
;
510 -- Deal with case of semicolon ending a subprogram declaration
512 elsif Token
= Tok_Semicolon
then
513 if not Pf_Flags
.Decl
then
517 Save_Scan_State
(Scan_State
);
518 Scan
; -- past semicolon
520 -- If semicolon is immediately followed by IS, then ignore the
521 -- semicolon, and go process the body.
523 if Token
= Tok_Is
then
524 Error_Msg_SP
-- CODEFIX
525 ("|extra "";"" ignored");
526 T_Is
; -- scan past IS
527 goto Subprogram_Body
;
529 -- If BEGIN follows in an appropriate column, we immediately
530 -- commence the error action of assuming that the previous
531 -- subprogram declaration should have been a subprogram body,
532 -- i.e. that the terminating semicolon should have been IS.
534 elsif Token
= Tok_Begin
535 and then Start_Column
>= Scope
.Table
(Scope
.Last
).Ecol
537 Error_Msg_SP
-- CODEFIX
538 ("|"";"" should be IS!");
539 goto Subprogram_Body
;
542 Restore_Scan_State
(Scan_State
);
543 goto Subprogram_Declaration
;
546 -- Case of not followed by semicolon
549 -- Subprogram renaming declaration case
551 Check_Misspelling_Of
(Tok_Renames
);
553 if Token
= Tok_Renames
then
554 if not Pf_Flags
.Rnam
then
555 Error_Msg_SC
("renaming declaration not allowed here!");
559 New_Node
(N_Subprogram_Renaming_Declaration
, Token_Ptr
);
560 Scan
; -- past RENAMES
561 Set_Name
(Rename_Node
, P_Name
);
562 Set_Specification
(Rename_Node
, Specification_Node
);
563 P_Aspect_Specifications
(Rename_Node
);
568 -- Case of IS following subprogram specification
570 elsif Token
= Tok_Is
then
571 T_Is
; -- ignore redundant Is's
573 if Token_Name
= Name_Abstract
then
574 Check_95_Keyword
(Tok_Abstract
, Tok_Semicolon
);
577 -- Deal nicely with (now obsolete) use of <> in place of abstract
579 if Token
= Tok_Box
then
580 Error_Msg_SC
-- CODEFIX
581 ("ABSTRACT expected");
582 Token
:= Tok_Abstract
;
585 -- Abstract subprogram declaration case
587 if Token
= Tok_Abstract
then
589 New_Node
(N_Abstract_Subprogram_Declaration
, Token_Ptr
);
590 Set_Specification
(Absdec_Node
, Specification_Node
);
591 Pop_Scope_Stack
; -- discard unneeded entry
592 Scan
; -- past ABSTRACT
593 P_Aspect_Specifications
(Absdec_Node
);
596 -- Ada 2005 (AI-248): Parse a null procedure declaration
598 elsif Token
= Tok_Null
then
599 if Ada_Version
< Ada_2005
then
600 Error_Msg_SP
("null procedures are an Ada 2005 extension");
601 Error_Msg_SP
("\unit must be compiled with -gnat05 switch");
607 Error_Msg_SP
("only procedures can be null");
609 Set_Null_Present
(Specification_Node
);
612 goto Subprogram_Declaration
;
614 -- Check for IS NEW with Formal_Part present and handle nicely
616 elsif Token
= Tok_New
then
618 ("formal part not allowed in instantiation", Fpart_Sloc
);
622 Inst_Node
:= New_Node
(N_Function_Instantiation
, Fproc_Sloc
);
625 New_Node
(N_Procedure_Instantiation
, Fproc_Sloc
);
628 Set_Defining_Unit_Name
(Inst_Node
, Name_Node
);
629 Set_Name
(Inst_Node
, P_Name
);
630 Set_Generic_Associations
(Inst_Node
, P_Generic_Actual_Part_Opt
);
632 Pop_Scope_Stack
; -- Don't need scope stack entry in this case
636 goto Subprogram_Body
;
639 -- Aspect specifications present
641 elsif Aspect_Specifications_Present
then
642 goto Subprogram_Declaration
;
644 -- Here we have a missing IS or missing semicolon
647 -- If the next token is a left paren at the start of a line, then
648 -- this is almost certainly the start of the expression for an
649 -- expression function, so in this case guess a missing IS.
651 if Token
= Tok_Left_Paren
and then Token_Is_At_Start_Of_Line
then
652 Error_Msg_AP
-- CODEFIX
655 -- In all other cases, we guess a missing semicolon, since we are
656 -- good at fixing up a semicolon which should really be an IS.
659 Error_Msg_AP
-- CODEFIX
661 SIS_Missing_Semicolon_Message
:= Get_Msg_Id
;
662 goto Subprogram_Declaration
;
667 -- Processing for stub or subprogram body or expression function
671 -- Subprogram body stub case
673 if Separate_Present
then
674 if not Pf_Flags
.Stub
then
675 Error_Msg_SC
("body stub not allowed here!");
678 if Nkind
(Name_Node
) = N_Defining_Operator_Symbol
then
680 ("operator symbol cannot be used as subunit name",
685 New_Node
(N_Subprogram_Body_Stub
, Sloc
(Specification_Node
));
686 Set_Specification
(Stub_Node
, Specification_Node
);
687 Scan
; -- past SEPARATE
692 -- Subprogram body or expression function case
695 Scan_Body_Or_Expression_Function
: declare
697 Body_Is_Hidden_In_SPARK
: Boolean;
698 Hidden_Region_Start
: Source_Ptr
;
700 function Likely_Expression_Function
return Boolean;
701 -- Returns True if we have a probable case of an expression
702 -- function omitting the parentheses, if so, returns True
703 -- and emits an appropriate error message, else returns False.
705 --------------------------------
706 -- Likely_Expression_Function --
707 --------------------------------
709 function Likely_Expression_Function
return Boolean is
711 -- If currently pointing to BEGIN or a declaration keyword
712 -- or a pragma, then we definitely have a subprogram body.
713 -- This is a common case, so worth testing first.
716 or else Token
in Token_Class_Declk
717 or else Token
= Tok_Pragma
721 -- Test for tokens which could only start an expression and
722 -- thus signal the case of a expression function.
724 elsif Token
in Token_Class_Literal
725 or else Token
in Token_Class_Unary_Addop
726 or else Token
= Tok_Left_Paren
727 or else Token
= Tok_Abs
728 or else Token
= Tok_Null
729 or else Token
= Tok_New
730 or else Token
= Tok_Not
734 -- Anything other than an identifier must be a body
736 elsif Token
/= Tok_Identifier
then
739 -- Here for an identifier
742 -- If the identifier is the first token on its line, then
743 -- let's assume that we have a missing begin and this is
744 -- intended as a subprogram body. However, if the context
745 -- is a function and the unit is a package declaration, a
746 -- body would be illegal, so try for an unparenthesized
747 -- expression function.
749 if Token_Is_At_Start_Of_Line
then
751 -- The enclosing scope entry is a subprogram spec
753 Spec_Node
: constant Node_Id
:=
755 (Scope
.Table
(Scope
.Last
).Labl
);
756 Lib_Node
: Node_Id
:= Spec_Node
;
759 -- Check whether there is an enclosing scope that
760 -- is a package declaration.
762 if Scope
.Last
> 1 then
764 Parent
(Scope
.Table
(Scope
.Last
- 1).Labl
);
767 if Ada_Version
>= Ada_2012
769 Nkind
(Lib_Node
) = N_Package_Specification
771 Nkind
(Spec_Node
) = N_Function_Specification
779 -- Otherwise we have to scan ahead. If the identifier is
780 -- followed by a colon or a comma, it is a declaration
781 -- and hence we have a subprogram body. Otherwise assume
782 -- a expression function.
786 Scan_State
: Saved_Scan_State
;
790 Save_Scan_State
(Scan_State
);
791 Scan
; -- past identifier
793 Restore_Scan_State
(Scan_State
);
795 if Tok
= Tok_Colon
or else Tok
= Tok_Comma
then
802 -- Fall through if we have a likely expression function
805 ("expression function must be enclosed in parentheses");
807 end Likely_Expression_Function
;
809 -- Start of processing for Scan_Body_Or_Expression_Function
812 -- Expression_Function case
814 if Token
= Tok_Left_Paren
815 or else Likely_Expression_Function
817 -- Check expression function allowed here
819 if not Pf_Flags
.Pexp
then
820 Error_Msg_SC
("expression function not allowed here!");
823 -- Check we are in Ada 2012 mode
825 if Ada_Version
< Ada_2012
then
827 ("expression function is an Ada 2012 feature!");
829 ("\unit must be compiled with -gnat2012 switch!");
832 -- Parse out expression and build expression function
836 (N_Expression_Function
, Sloc
(Specification_Node
));
837 Set_Specification
(Body_Node
, Specification_Node
);
838 Set_Expression
(Body_Node
, P_Expression
);
840 -- Expression functions can carry pre/postconditions
842 P_Aspect_Specifications
(Body_Node
);
845 -- Subprogram body case
848 -- Check body allowed here
850 if not Pf_Flags
.Pbod
then
851 Error_Msg_SP
("subprogram body not allowed here!");
854 -- Here is the test for a suspicious IS (i.e. one that
855 -- looks like it might more properly be a semicolon).
856 -- See separate section describing use of IS instead
857 -- of semicolon in package Parse.
859 if (Token
in Token_Class_Declk
861 Token
= Tok_Identifier
)
862 and then Start_Column
<= Scope
.Table
(Scope
.Last
).Ecol
863 and then Scope
.Last
/= 1
865 Scope
.Table
(Scope
.Last
).Etyp
:= E_Suspicious_Is
;
866 Scope
.Table
(Scope
.Last
).S_Is
:= Prev_Token_Ptr
;
869 -- Build and return subprogram body, parsing declarations
870 -- and statement sequence that belong to the body.
873 New_Node
(N_Subprogram_Body
, Sloc
(Specification_Node
));
874 Set_Specification
(Body_Node
, Specification_Node
);
876 -- If aspects are present, the specification is parsed as
877 -- a subprogram declaration, and we jump here after seeing
878 -- the keyword IS. Attach asspects previously collected to
881 if Is_Non_Empty_List
(Aspects
) then
882 Set_Parent
(Aspects
, Body_Node
);
883 Set_Aspect_Specifications
(Body_Node
, Aspects
);
886 -- In SPARK, a HIDE directive can be placed at the beginning
887 -- of a subprogram implementation, thus hiding the
888 -- subprogram body from SPARK tool-set. No violation of the
889 -- SPARK restriction should be issued on nodes in a hidden
890 -- part, which is obtained by marking such hidden parts.
892 if Token
= Tok_SPARK_Hide
then
893 Body_Is_Hidden_In_SPARK
:= True;
894 Hidden_Region_Start
:= Token_Ptr
;
895 Scan
; -- past HIDE directive
897 Body_Is_Hidden_In_SPARK
:= False;
900 Parse_Decls_Begin_End
(Body_Node
);
902 if Body_Is_Hidden_In_SPARK
then
903 Set_Hidden_Part_In_SPARK
(Hidden_Region_Start
, Token_Ptr
);
908 end Scan_Body_Or_Expression_Function
;
911 -- Processing for subprogram declaration
913 <<Subprogram_Declaration
>>
915 New_Node
(N_Subprogram_Declaration
, Sloc
(Specification_Node
));
916 Set_Specification
(Decl_Node
, Specification_Node
);
917 Aspects
:= Get_Aspect_Specifications
(Semicolon
=> False);
919 -- Aspects may be present on a subprogram body. The source parsed
920 -- so far is that of its specification, go parse the body and attach
921 -- the collected aspects, if any, to the body.
923 if Token
= Tok_Is
then
925 goto Subprogram_Body
;
928 if Is_Non_Empty_List
(Aspects
) then
929 Set_Parent
(Aspects
, Decl_Node
);
930 Set_Aspect_Specifications
(Decl_Node
, Aspects
);
936 -- If this is a context in which a subprogram body is permitted,
937 -- set active SIS entry in case (see section titled "Handling
938 -- Semicolon Used in Place of IS" in body of Parser package)
939 -- Note that SIS_Missing_Semicolon_Message is already set properly.
941 if Pf_Flags
.Pbod
then
942 SIS_Labl
:= Scope
.Table
(Scope
.Last
).Labl
;
943 SIS_Sloc
:= Scope
.Table
(Scope
.Last
).Sloc
;
944 SIS_Ecol
:= Scope
.Table
(Scope
.Last
).Ecol
;
945 SIS_Declaration_Node
:= Decl_Node
;
946 SIS_Semicolon_Sloc
:= Prev_Token_Ptr
;
947 SIS_Entry_Active
:= True;
954 ---------------------------------
955 -- 6.1 Subprogram Declaration --
956 ---------------------------------
958 -- Parsed by P_Subprogram (6.1)
960 ------------------------------------------
961 -- 6.1 Abstract Subprogram Declaration --
962 ------------------------------------------
964 -- Parsed by P_Subprogram (6.1)
966 -----------------------------------
967 -- 6.1 Subprogram Specification --
968 -----------------------------------
970 -- SUBPROGRAM_SPECIFICATION ::=
971 -- procedure DEFINING_PROGRAM_UNIT_NAME PARAMETER_PROFILE
972 -- | function DEFINING_DESIGNATOR PARAMETER_AND_RESULT_PROFILE
974 -- PARAMETER_PROFILE ::= [FORMAL_PART]
976 -- PARAMETER_AND_RESULT_PROFILE ::= [FORMAL_PART] return SUBTYPE_MARK
978 -- Subprogram specifications that appear in subprogram declarations
979 -- are parsed by P_Subprogram (6.1). This routine is used in other
980 -- contexts where subprogram specifications occur.
982 -- Note: this routine does not affect the scope stack in any way
984 -- Error recovery: can raise Error_Resync
986 function P_Subprogram_Specification
return Node_Id
is
987 Specification_Node
: Node_Id
;
988 Result_Not_Null
: Boolean;
989 Result_Node
: Node_Id
;
992 if Token
= Tok_Function
then
993 Specification_Node
:= New_Node
(N_Function_Specification
, Token_Ptr
);
994 Scan
; -- past FUNCTION
996 Set_Defining_Unit_Name
(Specification_Node
, P_Defining_Designator
);
997 Set_Parameter_Specifications
998 (Specification_Node
, P_Parameter_Profile
);
999 Check_Junk_Semicolon_Before_Return
;
1002 Result_Not_Null
:= P_Null_Exclusion
; -- Ada 2005 (AI-231)
1004 -- Ada 2005 (AI-318-02)
1006 if Token
= Tok_Access
then
1007 if Ada_Version
< Ada_2005
then
1009 ("anonymous access result type is an Ada 2005 extension");
1010 Error_Msg_SC
("\unit must be compiled with -gnat05 switch");
1013 Result_Node
:= P_Access_Definition
(Result_Not_Null
);
1016 Result_Node
:= P_Subtype_Mark
;
1017 No_Constraint_Maybe_Expr_Func
;
1020 Set_Null_Exclusion_Present
(Specification_Node
, Result_Not_Null
);
1021 Set_Result_Definition
(Specification_Node
, Result_Node
);
1022 return Specification_Node
;
1024 elsif Token
= Tok_Procedure
then
1025 Specification_Node
:= New_Node
(N_Procedure_Specification
, Token_Ptr
);
1026 Scan
; -- past PROCEDURE
1028 Set_Defining_Unit_Name
1029 (Specification_Node
, P_Defining_Program_Unit_Name
);
1030 Set_Parameter_Specifications
1031 (Specification_Node
, P_Parameter_Profile
);
1032 return Specification_Node
;
1035 Error_Msg_SC
("subprogram specification expected");
1038 end P_Subprogram_Specification
;
1040 ---------------------
1041 -- 6.1 Designator --
1042 ---------------------
1045 -- [PARENT_UNIT_NAME .] IDENTIFIER | OPERATOR_SYMBOL
1047 -- The caller has checked that the initial token is an identifier,
1048 -- operator symbol, or string literal. Note that we don't bother to
1049 -- do much error diagnosis in this routine, since it is only used for
1050 -- the label on END lines, and the routines in package Par.Endh will
1051 -- check that the label is appropriate.
1053 -- Error recovery: cannot raise Error_Resync
1055 function P_Designator
return Node_Id
is
1056 Ident_Node
: Node_Id
;
1057 Name_Node
: Node_Id
;
1058 Prefix_Node
: Node_Id
;
1060 function Real_Dot
return Boolean;
1061 -- Tests if a current token is an interesting period, i.e. is followed
1062 -- by an identifier or operator symbol or string literal. If not, it is
1063 -- probably just incorrect punctuation to be caught by our caller. Note
1064 -- that the case of an operator symbol or string literal is also an
1065 -- error, but that is an error that we catch here. If the result is
1066 -- True, a real dot has been scanned and we are positioned past it,
1067 -- if the result is False, the scan position is unchanged.
1073 function Real_Dot
return Boolean is
1074 Scan_State
: Saved_Scan_State
;
1077 if Token
/= Tok_Dot
then
1081 Save_Scan_State
(Scan_State
);
1084 if Token
= Tok_Identifier
1085 or else Token
= Tok_Operator_Symbol
1086 or else Token
= Tok_String_Literal
1091 Restore_Scan_State
(Scan_State
);
1097 -- Start of processing for P_Designator
1100 Ident_Node
:= Token_Node
;
1101 Scan
; -- past initial token
1103 if Prev_Token
= Tok_Operator_Symbol
1104 or else Prev_Token
= Tok_String_Literal
1105 or else not Real_Dot
1112 Prefix_Node
:= Ident_Node
;
1114 -- Loop through child names, on entry to this loop, Prefix contains
1115 -- the name scanned so far, and Ident_Node is the last identifier.
1118 Name_Node
:= New_Node
(N_Selected_Component
, Prev_Token_Ptr
);
1119 Set_Prefix
(Name_Node
, Prefix_Node
);
1120 Ident_Node
:= P_Identifier
;
1121 Set_Selector_Name
(Name_Node
, Ident_Node
);
1122 Prefix_Node
:= Name_Node
;
1123 exit when not Real_Dot
;
1126 -- On exit from the loop, Ident_Node is the last identifier scanned,
1127 -- i.e. the defining identifier, and Prefix_Node is a node for the
1128 -- entire name, structured (incorrectly!) as a selected component.
1130 Name_Node
:= Prefix
(Prefix_Node
);
1131 Change_Node
(Prefix_Node
, N_Designator
);
1132 Set_Name
(Prefix_Node
, Name_Node
);
1133 Set_Identifier
(Prefix_Node
, Ident_Node
);
1138 when Error_Resync
=>
1139 while Token
= Tok_Dot
or else Token
= Tok_Identifier
loop
1146 ------------------------------
1147 -- 6.1 Defining Designator --
1148 ------------------------------
1150 -- DEFINING_DESIGNATOR ::=
1151 -- DEFINING_PROGRAM_UNIT_NAME | DEFINING_OPERATOR_SYMBOL
1153 -- Error recovery: cannot raise Error_Resync
1155 function P_Defining_Designator
return Node_Id
is
1157 if Token
= Tok_Operator_Symbol
then
1158 return P_Defining_Operator_Symbol
;
1160 elsif Token
= Tok_String_Literal
then
1161 Error_Msg_SC
("invalid operator name");
1162 Scan
; -- past junk string
1166 return P_Defining_Program_Unit_Name
;
1168 end P_Defining_Designator
;
1170 -------------------------------------
1171 -- 6.1 Defining Program Unit Name --
1172 -------------------------------------
1174 -- DEFINING_PROGRAM_UNIT_NAME ::=
1175 -- [PARENT_UNIT_NAME .] DEFINING_IDENTIFIER
1177 -- Note: PARENT_UNIT_NAME may be present only in 95 mode at the outer level
1179 -- Error recovery: cannot raise Error_Resync
1181 function P_Defining_Program_Unit_Name
return Node_Id
is
1182 Ident_Node
: Node_Id
;
1183 Name_Node
: Node_Id
;
1184 Prefix_Node
: Node_Id
;
1187 -- Set identifier casing if not already set and scan initial identifier
1189 if Token
= Tok_Identifier
1190 and then Identifier_Casing
(Current_Source_File
) = Unknown
1192 Set_Identifier_Casing
(Current_Source_File
, Determine_Token_Casing
);
1195 Ident_Node
:= P_Identifier
(C_Dot
);
1196 Merge_Identifier
(Ident_Node
, Tok_Return
);
1198 -- Normal case (not child library unit name)
1200 if Token
/= Tok_Dot
then
1201 Change_Identifier_To_Defining_Identifier
(Ident_Node
);
1202 Warn_If_Standard_Redefinition
(Ident_Node
);
1205 -- Child library unit name case
1208 if Scope
.Last
> 1 then
1209 Error_Msg_SP
("child unit allowed only at library level");
1212 elsif Ada_Version
= Ada_83
then
1213 Error_Msg_SP
("(Ada 83) child unit not allowed!");
1217 Prefix_Node
:= Ident_Node
;
1219 -- Loop through child names, on entry to this loop, Prefix contains
1220 -- the name scanned so far, and Ident_Node is the last identifier.
1223 exit when Token
/= Tok_Dot
;
1224 Name_Node
:= New_Node
(N_Selected_Component
, Token_Ptr
);
1225 Scan
; -- past period
1226 Set_Prefix
(Name_Node
, Prefix_Node
);
1227 Ident_Node
:= P_Identifier
(C_Dot
);
1228 Set_Selector_Name
(Name_Node
, Ident_Node
);
1229 Prefix_Node
:= Name_Node
;
1232 -- On exit from the loop, Ident_Node is the last identifier scanned,
1233 -- i.e. the defining identifier, and Prefix_Node is a node for the
1234 -- entire name, structured (incorrectly!) as a selected component.
1236 Name_Node
:= Prefix
(Prefix_Node
);
1237 Change_Node
(Prefix_Node
, N_Defining_Program_Unit_Name
);
1238 Set_Name
(Prefix_Node
, Name_Node
);
1239 Change_Identifier_To_Defining_Identifier
(Ident_Node
);
1240 Warn_If_Standard_Redefinition
(Ident_Node
);
1241 Set_Defining_Identifier
(Prefix_Node
, Ident_Node
);
1243 -- All set with unit name parsed
1249 when Error_Resync
=>
1250 while Token
= Tok_Dot
or else Token
= Tok_Identifier
loop
1255 end P_Defining_Program_Unit_Name
;
1257 --------------------------
1258 -- 6.1 Operator Symbol --
1259 --------------------------
1261 -- OPERATOR_SYMBOL ::= STRING_LITERAL
1263 -- Operator symbol is returned by the scanner as Tok_Operator_Symbol
1265 -----------------------------------
1266 -- 6.1 Defining Operator Symbol --
1267 -----------------------------------
1269 -- DEFINING_OPERATOR_SYMBOL ::= OPERATOR_SYMBOL
1271 -- The caller has checked that the initial symbol is an operator symbol
1273 function P_Defining_Operator_Symbol
return Node_Id
is
1277 Op_Node
:= Token_Node
;
1278 Change_Operator_Symbol_To_Defining_Operator_Symbol
(Op_Node
);
1279 Scan
; -- past operator symbol
1281 end P_Defining_Operator_Symbol
;
1283 ----------------------------
1284 -- 6.1 Parameter_Profile --
1285 ----------------------------
1287 -- PARAMETER_PROFILE ::= [FORMAL_PART]
1289 -- Empty is returned if no formal part is present
1291 -- Error recovery: cannot raise Error_Resync
1293 function P_Parameter_Profile
return List_Id
is
1295 if Token
= Tok_Left_Paren
then
1296 Scan
; -- part left paren
1297 return P_Formal_Part
;
1301 end P_Parameter_Profile
;
1303 ---------------------------------------
1304 -- 6.1 Parameter And Result Profile --
1305 ---------------------------------------
1307 -- Parsed by its parent construct, which uses P_Parameter_Profile to
1308 -- parse the parameters, and P_Subtype_Mark to parse the return type.
1310 ----------------------
1311 -- 6.1 Formal part --
1312 ----------------------
1314 -- FORMAL_PART ::= (PARAMETER_SPECIFICATION {; PARAMETER_SPECIFICATION})
1316 -- PARAMETER_SPECIFICATION ::=
1317 -- DEFINING_IDENTIFIER_LIST : [ALIASED] MODE [NULL_EXCLUSION]
1318 -- SUBTYPE_MARK [:= DEFAULT_EXPRESSION]
1319 -- | DEFINING_IDENTIFIER_LIST : ACCESS_DEFINITION
1320 -- [:= DEFAULT_EXPRESSION]
1322 -- This scans the construct Formal_Part. The caller has already checked
1323 -- that the initial token is a left parenthesis, and skipped past it, so
1324 -- that on entry Token is the first token following the left parenthesis.
1326 -- Note: The ALIASED keyword is allowed only in Ada 2012 mode (AI 142)
1328 -- Error recovery: cannot raise Error_Resync
1330 function P_Formal_Part
return List_Id
is
1331 Specification_List
: List_Id
;
1332 Specification_Node
: Node_Id
;
1333 Scan_State
: Saved_Scan_State
;
1336 Ident_Sloc
: Source_Ptr
;
1337 Not_Null_Present
: Boolean := False;
1338 Not_Null_Sloc
: Source_Ptr
;
1340 Idents
: array (Int
range 1 .. 4096) of Entity_Id
;
1341 -- This array holds the list of defining identifiers. The upper bound
1342 -- of 4096 is intended to be essentially infinite, and we do not even
1343 -- bother to check for it being exceeded.
1346 Specification_List
:= New_List
;
1347 Specification_Loop
: loop
1349 if Token
= Tok_Pragma
then
1350 Error_Msg_SC
("pragma not allowed in formal part");
1351 Discard_Junk_Node
(P_Pragma
(Skipping
=> True));
1354 Ignore
(Tok_Left_Paren
);
1355 Ident_Sloc
:= Token_Ptr
;
1356 Idents
(1) := P_Defining_Identifier
(C_Comma_Colon
);
1360 exit Ident_Loop
when Token
= Tok_Colon
;
1362 -- The only valid tokens are colon and comma, so if we have
1363 -- neither do a bit of investigation to see which is the
1364 -- better choice for insertion.
1366 if Token
/= Tok_Comma
then
1368 -- Assume colon if ALIASED, IN or OUT keyword found
1370 exit Ident_Loop
when Token
= Tok_Aliased
or else
1371 Token
= Tok_In
or else
1374 -- Otherwise scan ahead
1376 Save_Scan_State
(Scan_State
);
1379 -- If we run into a semicolon, then assume that a
1380 -- colon was missing, e.g. Parms (X Y; ...). Also
1381 -- assume missing colon on EOF (a real disaster!)
1382 -- and on a right paren, e.g. Parms (X Y), and also
1383 -- on an assignment symbol, e.g. Parms (X Y := ..)
1385 if Token
= Tok_Semicolon
1386 or else Token
= Tok_Right_Paren
1387 or else Token
= Tok_EOF
1388 or else Token
= Tok_Colon_Equal
1390 Restore_Scan_State
(Scan_State
);
1393 -- If we run into a colon, assume that we had a missing
1394 -- comma, e.g. Parms (A B : ...). Also assume a missing
1395 -- comma if we hit another comma, e.g. Parms (A B, C ..)
1397 elsif Token
= Tok_Colon
1398 or else Token
= Tok_Comma
1400 Restore_Scan_State
(Scan_State
);
1405 end loop Look_Ahead
;
1408 -- Here if a comma is present, or to be assumed
1411 Num_Idents
:= Num_Idents
+ 1;
1412 Idents
(Num_Idents
) := P_Defining_Identifier
(C_Comma_Colon
);
1413 end loop Ident_Loop
;
1415 -- Fall through the loop on encountering a colon, or deciding
1416 -- that there is a missing colon.
1420 -- If there are multiple identifiers, we repeatedly scan the
1421 -- type and initialization expression information by resetting
1422 -- the scan pointer (so that we get completely separate trees
1423 -- for each occurrence).
1425 if Num_Idents
> 1 then
1426 Save_Scan_State
(Scan_State
);
1429 -- Loop through defining identifiers in list
1433 Ident_List_Loop
: loop
1434 Specification_Node
:=
1435 New_Node
(N_Parameter_Specification
, Ident_Sloc
);
1436 Set_Defining_Identifier
(Specification_Node
, Idents
(Ident
));
1438 -- Scan possible ALIASED for Ada 2012 (AI-142)
1440 if Token
= Tok_Aliased
then
1441 if Ada_Version
< Ada_2012
then
1442 Error_Msg_SC
("ALIASED parameter is an Ada 2012 feature");
1444 Set_Aliased_Present
(Specification_Node
);
1447 Scan
; -- past ALIASED
1450 -- Scan possible NOT NULL for Ada 2005 (AI-231, AI-447)
1452 Not_Null_Sloc
:= Token_Ptr
;
1454 P_Null_Exclusion
(Allow_Anonymous_In_95
=> True);
1456 -- Case of ACCESS keyword present
1458 if Token
= Tok_Access
then
1459 Set_Null_Exclusion_Present
1460 (Specification_Node
, Not_Null_Present
);
1462 if Ada_Version
= Ada_83
then
1463 Error_Msg_SC
("(Ada 83) access parameters not allowed");
1467 (Specification_Node
,
1468 P_Access_Definition
(Not_Null_Present
));
1470 -- Case of IN or OUT present
1473 if Token
= Tok_In
or else Token
= Tok_Out
then
1474 if Not_Null_Present
then
1476 ("`NOT NULL` can only be used with `ACCESS`",
1479 if Token
= Tok_In
then
1481 ("\`IN` not allowed together with `ACCESS`",
1485 ("\`OUT` not allowed together with `ACCESS`",
1490 P_Mode
(Specification_Node
);
1491 Not_Null_Present
:= P_Null_Exclusion
; -- Ada 2005 (AI-231)
1494 Set_Null_Exclusion_Present
1495 (Specification_Node
, Not_Null_Present
);
1497 if Token
= Tok_Procedure
1499 Token
= Tok_Function
1501 Error_Msg_SC
("formal subprogram parameter not allowed");
1504 if Token
= Tok_Left_Paren
then
1505 Discard_Junk_List
(P_Formal_Part
);
1508 if Token
= Tok_Return
then
1510 Discard_Junk_Node
(P_Subtype_Mark
);
1513 Set_Parameter_Type
(Specification_Node
, Error
);
1516 Set_Parameter_Type
(Specification_Node
, P_Subtype_Mark
);
1521 Set_Expression
(Specification_Node
, Init_Expr_Opt
(True));
1524 Set_Prev_Ids
(Specification_Node
, True);
1527 if Ident
< Num_Idents
then
1528 Set_More_Ids
(Specification_Node
, True);
1531 Append
(Specification_Node
, Specification_List
);
1532 exit Ident_List_Loop
when Ident
= Num_Idents
;
1534 Restore_Scan_State
(Scan_State
);
1535 end loop Ident_List_Loop
;
1538 when Error_Resync
=>
1539 Resync_Semicolon_List
;
1542 if Token
= Tok_Semicolon
then
1543 Save_Scan_State
(Scan_State
);
1544 Scan
; -- past semicolon
1546 -- If we have RETURN or IS after the semicolon, then assume
1547 -- that semicolon should have been a right parenthesis and exit
1549 if Token
= Tok_Is
or else Token
= Tok_Return
then
1550 Error_Msg_SP
-- CODEFIX
1551 ("|"";"" should be "")""");
1552 exit Specification_Loop
;
1555 -- If we have a declaration keyword after the semicolon, then
1556 -- assume we had a missing right parenthesis and terminate list
1558 if Token
in Token_Class_Declk
then
1559 Error_Msg_AP
-- CODEFIX
1561 Restore_Scan_State
(Scan_State
);
1562 exit Specification_Loop
;
1565 elsif Token
= Tok_Right_Paren
then
1566 Scan
; -- past right paren
1567 exit Specification_Loop
;
1569 -- Special check for common error of using comma instead of semicolon
1571 elsif Token
= Tok_Comma
then
1575 -- Special check for omitted separator
1577 elsif Token
= Tok_Identifier
then
1580 -- If nothing sensible, skip to next semicolon or right paren
1584 Resync_Semicolon_List
;
1586 if Token
= Tok_Semicolon
then
1587 Scan
; -- past semicolon
1590 exit Specification_Loop
;
1593 end loop Specification_Loop
;
1595 return Specification_List
;
1598 ----------------------------------
1599 -- 6.1 Parameter Specification --
1600 ----------------------------------
1602 -- Parsed by P_Formal_Part (6.1)
1608 -- MODE ::= [in] | in out | out
1610 -- There is no explicit node in the tree for the Mode. Instead the
1611 -- In_Present and Out_Present flags are set in the parent node to
1612 -- record the presence of keywords specifying the mode.
1614 -- Error_Recovery: cannot raise Error_Resync
1616 procedure P_Mode
(Node
: Node_Id
) is
1618 if Token
= Tok_In
then
1620 Set_In_Present
(Node
, True);
1622 if Style
.Mode_In_Check
and then Token
/= Tok_Out
then
1623 Error_Msg_SP
-- CODEFIX
1624 ("(style) IN should be omitted");
1627 -- Since Ada 2005, formal objects can have an anonymous access type,
1628 -- and of course carry a mode indicator.
1630 if Token
= Tok_Access
1631 and then Nkind
(Node
) /= N_Formal_Object_Declaration
1633 Error_Msg_SP
("IN not allowed together with ACCESS");
1634 Scan
; -- past ACCESS
1638 if Token
= Tok_Out
then
1640 Set_Out_Present
(Node
, True);
1643 if Token
= Tok_In
then
1644 Error_Msg_SC
("IN must precede OUT in parameter mode");
1646 Set_In_Present
(Node
, True);
1650 --------------------------
1651 -- 6.3 Subprogram Body --
1652 --------------------------
1654 -- Parsed by P_Subprogram (6.1)
1656 -----------------------------------
1657 -- 6.4 Procedure Call Statement --
1658 -----------------------------------
1660 -- Parsed by P_Sequence_Of_Statements (5.1)
1662 ------------------------
1663 -- 6.4 Function Call --
1664 ------------------------
1666 -- Parsed by P_Name (4.1)
1668 --------------------------------
1669 -- 6.4 Actual Parameter Part --
1670 --------------------------------
1672 -- Parsed by P_Name (4.1)
1674 --------------------------------
1675 -- 6.4 Parameter Association --
1676 --------------------------------
1678 -- Parsed by P_Name (4.1)
1680 ------------------------------------
1681 -- 6.4 Explicit Actual Parameter --
1682 ------------------------------------
1684 -- Parsed by P_Name (4.1)
1686 ---------------------------
1687 -- 6.5 Return Statement --
1688 ---------------------------
1690 -- SIMPLE_RETURN_STATEMENT ::= return [EXPRESSION];
1692 -- EXTENDED_RETURN_STATEMENT ::=
1693 -- return DEFINING_IDENTIFIER : [aliased] RETURN_SUBTYPE_INDICATION
1694 -- [:= EXPRESSION] [do
1695 -- HANDLED_SEQUENCE_OF_STATEMENTS
1698 -- RETURN_SUBTYPE_INDICATION ::= SUBTYPE_INDICATION | ACCESS_DEFINITION
1700 -- RETURN_STATEMENT ::= return [EXPRESSION];
1702 -- Error recovery: can raise Error_Resync
1704 procedure P_Return_Subtype_Indication
(Decl_Node
: Node_Id
) is
1706 -- Note: We don't need to check Ada_Version here, because this is
1707 -- only called in >= Ada 2005 cases anyway.
1709 Not_Null_Present
: constant Boolean := P_Null_Exclusion
;
1712 Set_Null_Exclusion_Present
(Decl_Node
, Not_Null_Present
);
1714 if Token
= Tok_Access
then
1715 Set_Object_Definition
1716 (Decl_Node
, P_Access_Definition
(Not_Null_Present
));
1718 Set_Object_Definition
1719 (Decl_Node
, P_Subtype_Indication
(Not_Null_Present
));
1721 end P_Return_Subtype_Indication
;
1723 -- Error recovery: can raise Error_Resync
1725 function P_Return_Object_Declaration
return Node_Id
is
1726 Return_Obj
: Node_Id
;
1727 Decl_Node
: Node_Id
;
1730 Return_Obj
:= Token_Node
;
1731 Change_Identifier_To_Defining_Identifier
(Return_Obj
);
1732 Warn_If_Standard_Redefinition
(Return_Obj
);
1733 Decl_Node
:= New_Node
(N_Object_Declaration
, Token_Ptr
);
1734 Set_Defining_Identifier
(Decl_Node
, Return_Obj
);
1736 Scan
; -- past identifier
1739 -- First an error check, if we have two identifiers in a row, a likely
1740 -- possibility is that the first of the identifiers is an incorrectly
1741 -- spelled keyword. See similar check in P_Identifier_Declarations.
1743 if Token
= Tok_Identifier
then
1745 SS
: Saved_Scan_State
;
1749 Save_Scan_State
(SS
);
1750 Scan
; -- past initial identifier
1751 I2
:= (Token
= Tok_Identifier
);
1752 Restore_Scan_State
(SS
);
1756 (Bad_Spelling_Of
(Tok_Access
) or else
1757 Bad_Spelling_Of
(Tok_Aliased
) or else
1758 Bad_Spelling_Of
(Tok_Constant
))
1765 -- We allow "constant" here (as in "return Result : constant
1766 -- T..."). This is not in the latest RM, but the ARG is considering an
1767 -- AI on the subject (see AI05-0015-1), which we expect to be approved.
1769 if Token
= Tok_Constant
then
1770 Scan
; -- past CONSTANT
1771 Set_Constant_Present
(Decl_Node
);
1773 if Token
= Tok_Aliased
then
1774 Error_Msg_SC
-- CODEFIX
1775 ("ALIASED should be before CONSTANT");
1776 Scan
; -- past ALIASED
1777 Set_Aliased_Present
(Decl_Node
);
1780 elsif Token
= Tok_Aliased
then
1781 Scan
; -- past ALIASED
1782 Set_Aliased_Present
(Decl_Node
);
1784 -- The restrictions on the use of aliased in an extended return
1785 -- are semantic, not syntactic.
1787 if Token
= Tok_Constant
then
1788 Scan
; -- past CONSTANT
1789 Set_Constant_Present
(Decl_Node
);
1793 P_Return_Subtype_Indication
(Decl_Node
);
1795 if Token
= Tok_Colon_Equal
then
1797 Set_Expression
(Decl_Node
, P_Expression_No_Right_Paren
);
1801 end P_Return_Object_Declaration
;
1803 -- Error recovery: can raise Error_Resync
1805 function P_Return_Statement
return Node_Id
is
1806 -- The caller has checked that the initial token is RETURN
1808 function Is_Simple
return Boolean;
1809 -- Scan state is just after RETURN (and is left that way).
1810 -- Determine whether this is a simple or extended return statement
1811 -- by looking ahead for "identifier :", which implies extended.
1817 function Is_Simple
return Boolean is
1818 Scan_State
: Saved_Scan_State
;
1819 Result
: Boolean := True;
1822 if Token
= Tok_Identifier
then
1823 Save_Scan_State
(Scan_State
); -- at identifier
1824 Scan
; -- past identifier
1826 if Token
= Tok_Colon
then
1827 Result
:= False; -- It's an extended_return_statement.
1830 Restore_Scan_State
(Scan_State
); -- to identifier
1836 Return_Sloc
: constant Source_Ptr
:= Token_Ptr
;
1837 Return_Node
: Node_Id
;
1839 -- Start of processing for P_Return_Statement
1842 Scan
; -- past RETURN
1844 -- Simple_return_statement, no expression, return an
1845 -- N_Simple_Return_Statement node with the expression field left Empty.
1847 if Token
= Tok_Semicolon
then
1849 Return_Node
:= New_Node
(N_Simple_Return_Statement
, Return_Sloc
);
1854 -- Simple_return_statement with expression
1856 -- We avoid trying to scan an expression if we are at an
1857 -- expression terminator since in that case the best error
1858 -- message is probably that we have a missing semicolon.
1861 Return_Node
:= New_Node
(N_Simple_Return_Statement
, Return_Sloc
);
1863 if Token
not in Token_Class_Eterm
then
1864 Set_Expression
(Return_Node
, P_Expression_No_Right_Paren
);
1867 -- Extended_return_statement (Ada 2005 only -- AI-318):
1870 if Ada_Version
< Ada_2005
then
1872 (" extended_return_statement is an Ada 2005 extension");
1873 Error_Msg_SP
("\unit must be compiled with -gnat05 switch");
1876 Return_Node
:= New_Node
(N_Extended_Return_Statement
, Return_Sloc
);
1877 Set_Return_Object_Declarations
1878 (Return_Node
, New_List
(P_Return_Object_Declaration
));
1880 if Token
= Tok_Do
then
1882 Scope
.Table
(Scope
.Last
).Etyp
:= E_Return
;
1883 Scope
.Table
(Scope
.Last
).Ecol
:= Start_Column
;
1884 Scope
.Table
(Scope
.Last
).Sloc
:= Return_Sloc
;
1887 Set_Handled_Statement_Sequence
1888 (Return_Node
, P_Handled_Sequence_Of_Statements
);
1891 -- Do we need to handle Error_Resync here???
1899 end P_Return_Statement
;