1 ------------------------------------------------------------------------------
3 -- GNAT COMPILER COMPONENTS --
10 -- Copyright (C) 1996-2002 Free Software Foundation, Inc. --
12 -- GNAT is free software; you can redistribute it and/or modify it under --
13 -- terms of the GNU General Public License as published by the Free Soft- --
14 -- ware Foundation; either version 2, or (at your option) any later ver- --
15 -- sion. GNAT is distributed in the hope that it will be useful, but WITH- --
16 -- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY --
17 -- or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License --
18 -- for more details. You should have received a copy of the GNU General --
19 -- Public License distributed with GNAT; see file COPYING. If not, write --
20 -- to the Free Software Foundation, 59 Temple Place - Suite 330, Boston, --
21 -- MA 02111-1307, USA. --
23 -- GNAT was originally developed by the GNAT team at New York University. --
24 -- Extensive contributions were provided by Ada Core Technologies Inc. --
26 ------------------------------------------------------------------------------
28 with Atree
; use Atree
;
29 with Einfo
; use Einfo
;
30 with Errout
; use Errout
;
31 with Targparm
; use Targparm
;
32 with Nlists
; use Nlists
;
34 with Sem_Util
; use Sem_Util
;
35 with Sinfo
; use Sinfo
;
36 with Snames
; use Snames
;
37 with Stand
; use Stand
;
39 package body Sem_Mech
is
41 -------------------------
42 -- Set_Mechanism_Value --
43 -------------------------
45 procedure Set_Mechanism_Value
(Ent
: Entity_Id
; Mech_Name
: Node_Id
) is
50 -- Signal bad descriptor class name
52 procedure Bad_Mechanism
;
53 -- Signal bad mechanism name
55 procedure Bad_Class
is
57 Error_Msg_N
("unrecognized descriptor class name", Class
);
60 procedure Bad_Mechanism
is
62 Error_Msg_N
("unrecognized mechanism name", Mech_Name
);
65 -- Start of processing for Set_Mechanism_Value
68 if Mechanism
(Ent
) /= Default_Mechanism
then
70 ("mechanism for & has already been set", Mech_Name
, Ent
);
73 -- MECHANISM_NAME ::= value | reference | descriptor
75 if Nkind
(Mech_Name
) = N_Identifier
then
76 if Chars
(Mech_Name
) = Name_Value
then
77 Set_Mechanism_With_Checks
(Ent
, By_Copy
, Mech_Name
);
80 elsif Chars
(Mech_Name
) = Name_Reference
then
81 Set_Mechanism_With_Checks
(Ent
, By_Reference
, Mech_Name
);
84 elsif Chars
(Mech_Name
) = Name_Descriptor
then
85 Check_VMS
(Mech_Name
);
86 Set_Mechanism_With_Checks
(Ent
, By_Descriptor
, Mech_Name
);
89 elsif Chars
(Mech_Name
) = Name_Copy
then
91 ("bad mechanism name, Value assumed", Mech_Name
);
92 Set_Mechanism
(Ent
, By_Copy
);
99 -- MECHANISM_NAME ::= descriptor (CLASS_NAME)
100 -- CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
102 -- Note: this form is parsed as an indexed component
104 elsif Nkind
(Mech_Name
) = N_Indexed_Component
then
105 Class
:= First
(Expressions
(Mech_Name
));
107 if Nkind
(Prefix
(Mech_Name
)) /= N_Identifier
108 or else Chars
(Prefix
(Mech_Name
)) /= Name_Descriptor
109 or else Present
(Next
(Class
))
115 -- MECHANISM_NAME ::= descriptor (Class => CLASS_NAME)
116 -- CLASS_NAME ::= ubs | ubsb | uba | s | sb | a | nca
118 -- Note: this form is parsed as a function call
120 elsif Nkind
(Mech_Name
) = N_Function_Call
then
122 Param
:= First
(Parameter_Associations
(Mech_Name
));
124 if Nkind
(Name
(Mech_Name
)) /= N_Identifier
125 or else Chars
(Name
(Mech_Name
)) /= Name_Descriptor
126 or else Present
(Next
(Param
))
127 or else No
(Selector_Name
(Param
))
128 or else Chars
(Selector_Name
(Param
)) /= Name_Class
133 Class
:= Explicit_Actual_Parameter
(Param
);
141 -- Fall through here with Class set to descriptor class name
143 Check_VMS
(Mech_Name
);
145 if Nkind
(Class
) /= N_Identifier
then
149 elsif Chars
(Class
) = Name_UBS
then
150 Set_Mechanism_With_Checks
(Ent
, By_Descriptor_UBS
, Mech_Name
);
152 elsif Chars
(Class
) = Name_UBSB
then
153 Set_Mechanism_With_Checks
(Ent
, By_Descriptor_UBSB
, Mech_Name
);
155 elsif Chars
(Class
) = Name_UBA
then
156 Set_Mechanism_With_Checks
(Ent
, By_Descriptor_UBA
, Mech_Name
);
158 elsif Chars
(Class
) = Name_S
then
159 Set_Mechanism_With_Checks
(Ent
, By_Descriptor_S
, Mech_Name
);
161 elsif Chars
(Class
) = Name_SB
then
162 Set_Mechanism_With_Checks
(Ent
, By_Descriptor_SB
, Mech_Name
);
164 elsif Chars
(Class
) = Name_A
then
165 Set_Mechanism_With_Checks
(Ent
, By_Descriptor_A
, Mech_Name
);
167 elsif Chars
(Class
) = Name_NCA
then
168 Set_Mechanism_With_Checks
(Ent
, By_Descriptor_NCA
, Mech_Name
);
175 end Set_Mechanism_Value
;
177 -------------------------------
178 -- Set_Mechanism_With_Checks --
179 -------------------------------
181 procedure Set_Mechanism_With_Checks
183 Mech
: Mechanism_Type
;
187 -- Right now we only do some checks for functions returning arguments
188 -- by desctiptor. Probably mode checks need to be added here ???
190 if Mech
in Descriptor_Codes
and then not Is_Formal
(Ent
) then
191 if Is_Record_Type
(Etype
(Ent
)) then
192 Error_Msg_N
("?records cannot be returned by Descriptor", Enod
);
197 -- If we fall through, all checks have passed
199 Set_Mechanism
(Ent
, Mech
);
200 end Set_Mechanism_With_Checks
;
206 procedure Set_Mechanisms
(E
: Entity_Id
) is
211 -- Skip this processing if inside a generic template. Not only is
212 -- it uneccessary (since neither extra formals nor mechanisms are
213 -- relevant for the template itself), but at least at the moment,
214 -- procedures get frozen early inside a template so attempting to
215 -- look at the formal types does not work too well if they are
216 -- private types that have not been frozen yet.
218 if Inside_A_Generic
then
222 -- Loop through formals
224 Formal
:= First_Formal
(E
);
225 while Present
(Formal
) loop
227 if Mechanism
(Formal
) = Default_Mechanism
then
228 Typ
:= Underlying_Type
(Etype
(Formal
));
230 -- If there is no underlying type, then skip this processing and
231 -- leave the convention set to Default_Mechanism. It seems odd
232 -- that there should ever be such cases but there are (see
233 -- comments for filed regression tests 1418-001 and 1912-009) ???
239 case Convention
(E
) is
245 -- Note: all RM defined conventions are treated the same
246 -- from the point of view of parameter passing mechanims
248 when Convention_Ada |
249 Convention_Intrinsic |
251 Convention_Protected |
252 Convention_Stubbed
=>
254 -- By reference types are passed by reference (RM 6.2(4))
256 if Is_By_Reference_Type
(Typ
) then
257 Set_Mechanism
(Formal
, By_Reference
);
259 -- By copy types are passed by copy (RM 6.2(3))
261 elsif Is_By_Copy_Type
(Typ
) then
262 Set_Mechanism
(Formal
, By_Copy
);
264 -- All other types we leave the Default_Mechanism set, so
265 -- that the backend can choose the appropriate method.
275 -- Note: Assembler, C++, Java, Stdcall also use C conventions
277 when Convention_Assembler |
281 Convention_Stdcall
=>
283 -- The following values are passed by copy
285 -- IN Scalar parameters (RM B.3(66))
286 -- IN parameters of access types (RM B.3(67))
287 -- Access parameters (RM B.3(68))
288 -- Access to subprogram types (RM B.3(71))
290 -- Note: in the case of access parameters, it is the
291 -- pointer that is passed by value. In GNAT access
292 -- parameters are treated as IN parameters of an
293 -- anonymous access type, so this falls out free.
295 -- The bottom line is that all IN elementary types
296 -- are passed by copy in GNAT.
298 if Is_Elementary_Type
(Typ
) then
299 if Ekind
(Formal
) = E_In_Parameter
then
300 Set_Mechanism
(Formal
, By_Copy
);
302 -- OUT and IN OUT parameters of elementary types are
303 -- passed by reference (RM B.3(68)). Note that we are
304 -- not following the advice to pass the address of a
305 -- copy to preserve by copy semantics.
308 Set_Mechanism
(Formal
, By_Reference
);
311 -- Records are normally passed by reference (RM B.3(69)).
312 -- However, this can be overridden by the use of the
313 -- C_Pass_By_Copy pragma or C_Pass_By_Copy convention.
315 elsif Is_Record_Type
(Typ
) then
317 -- If the record is not convention C, then we always
318 -- pass by reference, C_Pass_By_Copy does not apply.
320 if Convention
(Typ
) /= Convention_C
then
321 Set_Mechanism
(Formal
, By_Reference
);
323 -- If convention C_Pass_By_Copy was specified for
324 -- the record type, then we pass by copy.
326 elsif C_Pass_By_Copy
(Typ
) then
327 Set_Mechanism
(Formal
, By_Copy
);
329 -- Otherwise, for a C convention record, we set the
330 -- convention in accordance with a possible use of
331 -- the C_Pass_By_Copy pragma. Note that the value of
332 -- Default_C_Record_Mechanism in the absence of such
333 -- a pragma is By_Reference.
336 Set_Mechanism
(Formal
, Default_C_Record_Mechanism
);
339 -- Array types are passed by reference (B.3 (71))
341 elsif Is_Array_Type
(Typ
) then
342 Set_Mechanism
(Formal
, By_Reference
);
344 -- For all other types, use Default_Mechanism mechanism
354 when Convention_COBOL
=>
356 -- Access parameters (which in GNAT look like IN parameters
357 -- of an access type) are passed by copy (RM B.4(96)) as
358 -- are all other IN parameters of scalar type (RM B.4(97)).
360 -- For now we pass these parameters by reference as well.
361 -- The RM specifies the intent BY_CONTENT, but gigi does
362 -- not currently transform By_Copy properly. If we pass by
363 -- reference, it will be imperative to introduce copies ???
365 if Is_Elementary_Type
(Typ
)
366 and then Ekind
(Formal
) = E_In_Parameter
368 Set_Mechanism
(Formal
, By_Reference
);
370 -- All other parameters (i.e. all non-scalar types, and
371 -- all OUT or IN OUT parameters) are passed by reference.
372 -- Note that at the moment we are not bothering to make
373 -- copies of scalar types as recommended in the RM.
376 Set_Mechanism
(Formal
, By_Reference
);
383 when Convention_Fortran
=>
385 -- In OpenVMS, pass a character of array of character
386 -- value using Descriptor(S).
389 and then (Root_Type
(Typ
) = Standard_Character
393 Root_Type
(Component_Type
(Typ
)) =
396 Set_Mechanism
(Formal
, By_Descriptor_S
);
398 -- Access types are passed by default (presumably this
399 -- will mean they are passed by copy)
401 elsif Is_Access_Type
(Typ
) then
404 -- For now, we pass all other parameters by reference.
405 -- It is not clear that this is right in the long run,
406 -- but it seems to correspond to what gnu f77 wants.
409 Set_Mechanism
(Formal
, By_Reference
);
415 <<Skip_Formal
>> -- remove this when problem above is fixed ???
417 Next_Formal
(Formal
);
420 -- Now deal with return type, we always leave the default mechanism
421 -- set except for the case of returning a By_Reference type for an
422 -- Ada convention, where we force return by reference
424 if Ekind
(E
) = E_Function
425 and then Mechanism
(E
) = Default_Mechanism
426 and then not Has_Foreign_Convention
(E
)
427 and then Is_By_Reference_Type
(Etype
(E
))
429 Set_Mechanism
(E
, By_Reference
);