OSDN Git Service

2007-04-20 Robert Dewar <dewar@adacore.com>
[pf3gnuchains/gcc-fork.git] / gcc / ada / exp_strm.adb
1 ------------------------------------------------------------------------------
2 --                                                                          --
3 --                         GNAT COMPILER COMPONENTS                         --
4 --                                                                          --
5 --                             E X P _ S T R M                              --
6 --                                                                          --
7 --                                 B o d y                                  --
8 --                                                                          --
9 --          Copyright (C) 1992-2007, 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 2,  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 COPYING.  If not, write --
19 -- to  the  Free Software Foundation,  51  Franklin  Street,  Fifth  Floor, --
20 -- Boston, MA 02110-1301, USA.                                              --
21 --                                                                          --
22 -- GNAT was originally developed  by the GNAT team at  New York University. --
23 -- Extensive contributions were provided by Ada Core Technologies Inc.      --
24 --                                                                          --
25 ------------------------------------------------------------------------------
26
27 with Atree;    use Atree;
28 with Einfo;    use Einfo;
29 with Namet;    use Namet;
30 with Nlists;   use Nlists;
31 with Nmake;    use Nmake;
32 with Rtsfind;  use Rtsfind;
33 with Sem_Util; use Sem_Util;
34 with Sinfo;    use Sinfo;
35 with Snames;   use Snames;
36 with Stand;    use Stand;
37 with Tbuild;   use Tbuild;
38 with Ttypes;   use Ttypes;
39 with Uintp;    use Uintp;
40
41 package body Exp_Strm is
42
43    -----------------------
44    -- Local Subprograms --
45    -----------------------
46
47    procedure Build_Array_Read_Write_Procedure
48      (Nod  : Node_Id;
49       Typ  : Entity_Id;
50       Decl : out Node_Id;
51       Pnam : Entity_Id;
52       Nam  : Name_Id);
53    --  Common routine shared to build either an array Read procedure or an
54    --  array Write procedure, Nam is Name_Read or Name_Write to select which.
55    --  Pnam is the defining identifier for the constructed procedure. The
56    --  other parameters are as for Build_Array_Read_Procedure except that
57    --  the first parameter Nod supplies the Sloc to be used to generate code.
58
59    procedure Build_Record_Read_Write_Procedure
60      (Loc  : Source_Ptr;
61       Typ  : Entity_Id;
62       Decl : out Node_Id;
63       Pnam : Entity_Id;
64       Nam  : Name_Id);
65    --  Common routine shared to build a record Read Write procedure, Nam
66    --  is Name_Read or Name_Write to select which. Pnam is the defining
67    --  identifier for the constructed procedure. The other parameters are
68    --  as for Build_Record_Read_Procedure.
69
70    procedure Build_Stream_Function
71      (Loc   : Source_Ptr;
72       Typ   : Entity_Id;
73       Decl  : out Node_Id;
74       Fnam  : Entity_Id;
75       Decls : List_Id;
76       Stms  : List_Id);
77    --  Called to build an array or record stream function. The first three
78    --  arguments are the same as Build_Record_Or_Elementary_Input_Function.
79    --  Decls and Stms are the declarations and statements for the body and
80    --  The parameter Fnam is the name of the constructed function.
81
82    function Has_Stream_Standard_Rep (U_Type : Entity_Id) return Boolean;
83    --  This function is used to test the type U_Type, to determine if it has
84    --  a standard representation from a streaming point of view. Standard means
85    --  that it has a standard representation (e.g. no enumeration rep clause),
86    --  and the size of the root type is the same as the streaming size (which
87    --  is defined as value specified by a Stream_Size clause if present, or
88    --  the Esize of U_Type if not).
89
90    function Make_Stream_Subprogram_Name
91      (Loc : Source_Ptr;
92       Typ : Entity_Id;
93       Nam : TSS_Name_Type) return Entity_Id;
94    --  Return the entity that identifies the stream subprogram for type Typ
95    --  that is identified by the given Nam. This procedure deals with the
96    --  difference between tagged types (where a single subprogram associated
97    --  with the type is generated) and all other cases (where a subprogram
98    --  is generated at the point of the stream attribute reference). The
99    --  Loc parameter is used as the Sloc of the created entity.
100
101    function Stream_Base_Type (E : Entity_Id) return Entity_Id;
102    --  Stream attributes work on the basis of the base type except for the
103    --  array case. For the array case, we do not go to the base type, but
104    --  to the first subtype if it is constrained. This avoids problems with
105    --  incorrect conversions in the packed array case. Stream_Base_Type is
106    --  exactly this function (returns the base type, unless we have an array
107    --  type whose first subtype is constrained, in which case it returns the
108    --  first subtype).
109
110    --------------------------------
111    -- Build_Array_Input_Function --
112    --------------------------------
113
114    --  The function we build looks like
115
116    --    function typSI[_nnn] (S : access RST) return Typ is
117    --      L1 : constant Index_Type_1 := Index_Type_1'Input (S);
118    --      H1 : constant Index_Type_1 := Index_Type_1'Input (S);
119    --      L2 : constant Index_Type_2 := Index_Type_2'Input (S);
120    --      H2 : constant Index_Type_2 := Index_Type_2'Input (S);
121    --      ..
122    --      Ln : constant Index_Type_n := Index_Type_n'Input (S);
123    --      Hn : constant Index_Type_n := Index_Type_n'Input (S);
124    --
125    --      V : Typ'Base (L1 .. H1, L2 .. H2, ... Ln .. Hn)
126
127    --    begin
128    --      Typ'Read (S, V);
129    --      return V;
130    --    end typSI[_nnn]
131
132    --  Note: the suffix [_nnn] is present for non-tagged types, where we
133    --  generate a local subprogram at the point of the occurrence of the
134    --  attribute reference, so the name must be unique.
135
136    procedure Build_Array_Input_Function
137      (Loc  : Source_Ptr;
138       Typ  : Entity_Id;
139       Decl : out Node_Id;
140       Fnam : out Entity_Id)
141    is
142       Dim    : constant Pos := Number_Dimensions (Typ);
143       Lnam   : Name_Id;
144       Hnam   : Name_Id;
145       Decls  : List_Id;
146       Ranges : List_Id;
147       Stms   : List_Id;
148       Indx   : Node_Id;
149
150    begin
151       Decls := New_List;
152       Ranges := New_List;
153       Indx  := First_Index (Typ);
154
155       for J in 1 .. Dim loop
156          Lnam := New_External_Name ('L', J);
157          Hnam := New_External_Name ('H', J);
158
159          Append_To (Decls,
160            Make_Object_Declaration (Loc,
161              Defining_Identifier => Make_Defining_Identifier (Loc, Lnam),
162              Constant_Present    => True,
163              Object_Definition   => New_Occurrence_Of (Etype (Indx), Loc),
164              Expression =>
165                Make_Attribute_Reference (Loc,
166                  Prefix =>
167                    New_Occurrence_Of (Stream_Base_Type (Etype (Indx)), Loc),
168                  Attribute_Name => Name_Input,
169                  Expressions => New_List (Make_Identifier (Loc, Name_S)))));
170
171          Append_To (Decls,
172            Make_Object_Declaration (Loc,
173              Defining_Identifier => Make_Defining_Identifier (Loc, Hnam),
174              Constant_Present    => True,
175              Object_Definition   =>
176                    New_Occurrence_Of (Stream_Base_Type (Etype (Indx)), Loc),
177              Expression =>
178                Make_Attribute_Reference (Loc,
179                  Prefix =>
180                    New_Occurrence_Of (Stream_Base_Type (Etype (Indx)), Loc),
181                  Attribute_Name => Name_Input,
182                  Expressions => New_List (Make_Identifier (Loc, Name_S)))));
183
184          Append_To (Ranges,
185            Make_Range (Loc,
186              Low_Bound  => Make_Identifier (Loc, Lnam),
187              High_Bound => Make_Identifier (Loc, Hnam)));
188
189          Next_Index (Indx);
190       end loop;
191
192       --  If the first subtype is constrained, use it directly. Otherwise
193       --  build a subtype indication with the proper bounds.
194
195       if Is_Constrained (Stream_Base_Type (Typ)) then
196          Append_To (Decls,
197            Make_Object_Declaration (Loc,
198              Defining_Identifier => Make_Defining_Identifier (Loc, Name_V),
199              Object_Definition =>
200                New_Occurrence_Of (Stream_Base_Type (Typ), Loc)));
201       else
202          Append_To (Decls,
203            Make_Object_Declaration (Loc,
204              Defining_Identifier => Make_Defining_Identifier (Loc, Name_V),
205              Object_Definition =>
206                Make_Subtype_Indication (Loc,
207                  Subtype_Mark =>
208                    New_Occurrence_Of (Stream_Base_Type (Typ), Loc),
209                  Constraint =>
210                    Make_Index_Or_Discriminant_Constraint (Loc,
211                      Constraints => Ranges))));
212       end if;
213
214       Stms := New_List (
215          Make_Attribute_Reference (Loc,
216            Prefix => New_Occurrence_Of (Typ, Loc),
217            Attribute_Name => Name_Read,
218            Expressions => New_List (
219              Make_Identifier (Loc, Name_S),
220              Make_Identifier (Loc, Name_V))),
221
222          Make_Return_Statement (Loc,
223            Expression => Make_Identifier (Loc, Name_V)));
224
225       Fnam :=
226         Make_Defining_Identifier (Loc,
227           Chars => Make_TSS_Name_Local (Typ, TSS_Stream_Input));
228
229       Build_Stream_Function (Loc, Typ, Decl, Fnam, Decls, Stms);
230    end Build_Array_Input_Function;
231
232    ----------------------------------
233    -- Build_Array_Output_Procedure --
234    ----------------------------------
235
236    procedure Build_Array_Output_Procedure
237      (Loc  : Source_Ptr;
238       Typ  : Entity_Id;
239       Decl : out Node_Id;
240       Pnam : out Entity_Id)
241    is
242       Stms : List_Id;
243       Indx : Node_Id;
244
245    begin
246       --  Build series of statements to output bounds
247
248       Indx := First_Index (Typ);
249       Stms := New_List;
250
251       for J in 1 .. Number_Dimensions (Typ) loop
252          Append_To (Stms,
253            Make_Attribute_Reference (Loc,
254              Prefix =>
255                New_Occurrence_Of (Stream_Base_Type (Etype (Indx)), Loc),
256              Attribute_Name => Name_Write,
257              Expressions => New_List (
258                Make_Identifier (Loc, Name_S),
259                Make_Attribute_Reference (Loc,
260                  Prefix => Make_Identifier (Loc, Name_V),
261                  Attribute_Name => Name_First,
262                  Expressions => New_List (
263                    Make_Integer_Literal (Loc, J))))));
264
265          Append_To (Stms,
266            Make_Attribute_Reference (Loc,
267              Prefix =>
268                New_Occurrence_Of (Stream_Base_Type (Etype (Indx)), Loc),
269              Attribute_Name => Name_Write,
270              Expressions => New_List (
271                Make_Identifier (Loc, Name_S),
272                Make_Attribute_Reference (Loc,
273                  Prefix => Make_Identifier (Loc, Name_V),
274                  Attribute_Name => Name_Last,
275                  Expressions => New_List (
276                    Make_Integer_Literal (Loc, J))))));
277
278          Next_Index (Indx);
279       end loop;
280
281       --  Append Write attribute to write array elements
282
283       Append_To (Stms,
284         Make_Attribute_Reference (Loc,
285           Prefix => New_Occurrence_Of (Typ, Loc),
286           Attribute_Name => Name_Write,
287           Expressions => New_List (
288             Make_Identifier (Loc, Name_S),
289             Make_Identifier (Loc, Name_V))));
290
291       Pnam :=
292         Make_Defining_Identifier (Loc,
293           Chars => Make_TSS_Name_Local (Typ, TSS_Stream_Output));
294
295       Build_Stream_Procedure (Loc, Typ, Decl, Pnam, Stms, False);
296    end Build_Array_Output_Procedure;
297
298    --------------------------------
299    -- Build_Array_Read_Procedure --
300    --------------------------------
301
302    procedure Build_Array_Read_Procedure
303      (Nod  : Node_Id;
304       Typ  : Entity_Id;
305       Decl : out Node_Id;
306       Pnam : out Entity_Id)
307    is
308       Loc : constant Source_Ptr := Sloc (Nod);
309
310    begin
311       Pnam :=
312         Make_Defining_Identifier (Loc,
313           Chars => Make_TSS_Name_Local (Typ, TSS_Stream_Read));
314       Build_Array_Read_Write_Procedure (Nod, Typ, Decl, Pnam, Name_Read);
315    end Build_Array_Read_Procedure;
316
317    --------------------------------------
318    -- Build_Array_Read_Write_Procedure --
319    --------------------------------------
320
321    --  The form of the array read/write procedure is as follows:
322
323    --    procedure pnam (S : access RST, V : [out] Typ) is
324    --    begin
325    --       for L1 in V'Range (1) loop
326    --          for L2 in V'Range (2) loop
327    --             ...
328    --                for Ln in V'Range (n) loop
329    --                   Component_Type'Read/Write (S, V (L1, L2, .. Ln));
330    --                end loop;
331    --             ..
332    --          end loop;
333    --       end loop
334    --    end pnam;
335
336    --  The out keyword for V is supplied in the Read case
337
338    procedure Build_Array_Read_Write_Procedure
339      (Nod  : Node_Id;
340       Typ  : Entity_Id;
341       Decl : out Node_Id;
342       Pnam : Entity_Id;
343       Nam  : Name_Id)
344    is
345       Loc  : constant Source_Ptr := Sloc (Nod);
346       Ndim : constant Pos        := Number_Dimensions (Typ);
347       Ctyp : constant Entity_Id  := Component_Type (Typ);
348
349       Stm  : Node_Id;
350       Exl  : List_Id;
351       RW   : Entity_Id;
352
353    begin
354       --  First build the inner attribute call
355
356       Exl := New_List;
357
358       for J in 1 .. Ndim loop
359          Append_To (Exl, Make_Identifier (Loc, New_External_Name ('L', J)));
360       end loop;
361
362       Stm :=
363         Make_Attribute_Reference (Loc,
364           Prefix => New_Occurrence_Of (Stream_Base_Type (Ctyp), Loc),
365           Attribute_Name => Nam,
366           Expressions => New_List (
367             Make_Identifier (Loc, Name_S),
368             Make_Indexed_Component (Loc,
369               Prefix => Make_Identifier (Loc, Name_V),
370               Expressions => Exl)));
371
372       --  The corresponding stream attribute for the component type of the
373       --  array may be user-defined, and be frozen after the type for which
374       --  we are generating the stream subprogram. In that case, freeze the
375       --  stream attribute of the component type, whose declaration could not
376       --  generate any additional freezing actions in any case. See 5509-003.
377
378       if Nam = Name_Read then
379          RW := TSS (Base_Type (Ctyp), TSS_Stream_Read);
380       else
381          RW := TSS (Base_Type (Ctyp), TSS_Stream_Write);
382       end if;
383
384       if Present (RW)
385         and then not Is_Frozen (RW)
386       then
387          Set_Is_Frozen (RW);
388       end if;
389
390       --  Now this is the big loop to wrap that statement up in a sequence
391       --  of loops. The first time around, Stm is the attribute call. The
392       --  second and subsequent times, Stm is an inner loop.
393
394       for J in 1 .. Ndim loop
395          Stm :=
396            Make_Implicit_Loop_Statement (Nod,
397              Iteration_Scheme =>
398                Make_Iteration_Scheme (Loc,
399                  Loop_Parameter_Specification =>
400                    Make_Loop_Parameter_Specification (Loc,
401                      Defining_Identifier =>
402                        Make_Defining_Identifier (Loc,
403                          Chars => New_External_Name ('L', Ndim - J + 1)),
404
405                      Discrete_Subtype_Definition =>
406                        Make_Attribute_Reference (Loc,
407                          Prefix => Make_Identifier (Loc, Name_V),
408                          Attribute_Name => Name_Range,
409
410                          Expressions => New_List (
411                            Make_Integer_Literal (Loc, Ndim - J + 1))))),
412
413              Statements => New_List (Stm));
414
415       end loop;
416
417       Build_Stream_Procedure
418         (Loc, Typ, Decl, Pnam, New_List (Stm), Nam = Name_Read);
419    end Build_Array_Read_Write_Procedure;
420
421    ---------------------------------
422    -- Build_Array_Write_Procedure --
423    ---------------------------------
424
425    procedure Build_Array_Write_Procedure
426      (Nod  : Node_Id;
427       Typ  : Entity_Id;
428       Decl : out Node_Id;
429       Pnam : out Entity_Id)
430    is
431       Loc : constant Source_Ptr := Sloc (Nod);
432
433    begin
434       Pnam :=
435         Make_Defining_Identifier (Loc,
436           Chars => Make_TSS_Name_Local (Typ, TSS_Stream_Write));
437       Build_Array_Read_Write_Procedure (Nod, Typ, Decl, Pnam, Name_Write);
438    end Build_Array_Write_Procedure;
439
440    ---------------------------------
441    -- Build_Elementary_Input_Call --
442    ---------------------------------
443
444    function Build_Elementary_Input_Call (N : Node_Id) return Node_Id is
445       Loc     : constant Source_Ptr := Sloc (N);
446       P_Type  : constant Entity_Id  := Entity (Prefix (N));
447       U_Type  : constant Entity_Id  := Underlying_Type (P_Type);
448       Rt_Type : constant Entity_Id  := Root_Type (U_Type);
449       FST     : constant Entity_Id  := First_Subtype (U_Type);
450       Strm    : constant Node_Id    := First (Expressions (N));
451       Targ    : constant Node_Id    := Next (Strm);
452       P_Size  : Uint;
453       Res     : Node_Id;
454       Lib_RE  : RE_Id;
455
456    begin
457       --  Compute the size of the stream element. This is either the size of
458       --  the first subtype or if given the size of the Stream_Size attribute.
459
460       if Has_Stream_Size_Clause (FST) then
461          P_Size := Static_Integer (Expression (Stream_Size_Clause (FST)));
462       else
463          P_Size := Esize (FST);
464       end if;
465
466       --  Check first for Boolean and Character. These are enumeration types,
467       --  but we treat them specially, since they may require special handling
468       --  in the transfer protocol. However, this special handling only applies
469       --  if they have standard representation, otherwise they are treated like
470       --  any other enumeration type.
471
472       if Rt_Type = Standard_Boolean
473         and then Has_Stream_Standard_Rep (U_Type)
474       then
475          Lib_RE := RE_I_B;
476
477       elsif Rt_Type = Standard_Character
478         and then Has_Stream_Standard_Rep (U_Type)
479       then
480          Lib_RE := RE_I_C;
481
482       elsif Rt_Type = Standard_Wide_Character
483         and then Has_Stream_Standard_Rep (U_Type)
484       then
485          Lib_RE := RE_I_WC;
486
487       elsif Rt_Type = Standard_Wide_Wide_Character
488         and then Has_Stream_Standard_Rep (U_Type)
489       then
490          Lib_RE := RE_I_WWC;
491
492       --  Floating point types
493
494       elsif Is_Floating_Point_Type (U_Type) then
495
496          --  Question: should we use P_Size or Rt_Type to distinguish between
497          --  possible floating point types? If a non-standard size or a stream
498          --  size is specified, then we should certainly use the size. But if
499          --  we have two types the same (notably Short_Float_Size = Float_Size
500          --  which is close to universally true, and Long_Long_Float_Size =
501          --  Long_Float_Size, true on most targets except the x86), then we
502          --  would really rather use the root type, so that if people want to
503          --  fiddle with System.Stream_Attributes to get inter-target portable
504          --  streams, they get the size they expect. Consider in particular the
505          --  case of a stream written on an x86, with 96-bit Long_Long_Float
506          --  being read into a non-x86 target with 64 bit Long_Long_Float. A
507          --  special version of System.Stream_Attributes can deal with this
508          --  provided the proper type is always used.
509
510          --  To deal with these two requirements we add the special checks
511          --  on equal sizes and use the root type to distinguish.
512
513          if P_Size <= Standard_Short_Float_Size
514            and then (Standard_Short_Float_Size /= Standard_Float_Size
515                      or else Rt_Type = Standard_Short_Float)
516          then
517             Lib_RE := RE_I_SF;
518
519          elsif P_Size <= Standard_Float_Size then
520             Lib_RE := RE_I_F;
521
522          elsif P_Size <= Standard_Long_Float_Size
523            and then (Standard_Long_Float_Size /= Standard_Long_Long_Float_Size
524                        or else Rt_Type = Standard_Float)
525          then
526             Lib_RE := RE_I_LF;
527
528          else
529             Lib_RE := RE_I_LLF;
530          end if;
531
532       --  Signed integer types. Also includes signed fixed-point types and
533       --  enumeration types with a signed representation.
534
535       --  Note on signed integer types. We do not consider types as signed for
536       --  this purpose if they have no negative numbers, or if they have biased
537       --  representation. The reason is that the value in either case basically
538       --  represents an unsigned value.
539
540       --  For example, consider:
541
542       --     type W is range 0 .. 2**32 - 1;
543       --     for W'Size use 32;
544
545       --  This is a signed type, but the representation is unsigned, and may
546       --  be outside the range of a 32-bit signed integer, so this must be
547       --  treated as 32-bit unsigned.
548
549       --  Similarly, if we have
550
551       --     type W is range -1 .. +254;
552       --     for W'Size use 8;
553
554       --  then the representation is unsigned
555
556       elsif not Is_Unsigned_Type (FST)
557         and then
558           (Is_Fixed_Point_Type (U_Type)
559              or else
560            Is_Enumeration_Type (U_Type)
561              or else
562            (Is_Signed_Integer_Type (U_Type)
563               and then not Has_Biased_Representation (FST)))
564       then
565          if P_Size <= Standard_Short_Short_Integer_Size then
566             Lib_RE := RE_I_SSI;
567
568          elsif P_Size <= Standard_Short_Integer_Size then
569             Lib_RE := RE_I_SI;
570
571          elsif P_Size <= Standard_Integer_Size then
572             Lib_RE := RE_I_I;
573
574          elsif P_Size <= Standard_Long_Integer_Size then
575             Lib_RE := RE_I_LI;
576
577          else
578             Lib_RE := RE_I_LLI;
579          end if;
580
581       --  Unsigned integer types, also includes unsigned fixed-point types
582       --  and enumeration types with an unsigned representation (note that
583       --  we know they are unsigned because we already tested for signed).
584
585       --  Also includes signed integer types that are unsigned in the sense
586       --  that they do not include negative numbers. See above for details.
587
588       elsif Is_Modular_Integer_Type    (U_Type)
589         or else Is_Fixed_Point_Type    (U_Type)
590         or else Is_Enumeration_Type    (U_Type)
591         or else Is_Signed_Integer_Type (U_Type)
592       then
593          if P_Size <= Standard_Short_Short_Integer_Size then
594             Lib_RE := RE_I_SSU;
595
596          elsif P_Size <= Standard_Short_Integer_Size then
597             Lib_RE := RE_I_SU;
598
599          elsif P_Size <= Standard_Integer_Size then
600             Lib_RE := RE_I_U;
601
602          elsif P_Size <= Standard_Long_Integer_Size then
603             Lib_RE := RE_I_LU;
604
605          else
606             Lib_RE := RE_I_LLU;
607          end if;
608
609       else pragma Assert (Is_Access_Type (U_Type));
610          if P_Size > System_Address_Size then
611             Lib_RE := RE_I_AD;
612          else
613             Lib_RE := RE_I_AS;
614          end if;
615       end if;
616
617       --  Call the function, and do an unchecked conversion of the result
618       --  to the actual type of the prefix. If the target is a discriminant,
619       --  and we are in the body of the default implementation of a 'Read
620       --  attribute, set target type to force a constraint check (13.13.2(35)).
621       --  If the type of the discriminant is currently private, add another
622       --  unchecked conversion from the full view.
623
624       if Nkind (Targ) = N_Identifier
625         and then Is_Internal_Name (Chars (Targ))
626         and then Is_TSS (Scope (Entity (Targ)), TSS_Stream_Read)
627       then
628          Res :=
629            Unchecked_Convert_To (Base_Type (U_Type),
630              Make_Function_Call (Loc,
631                Name => New_Occurrence_Of (RTE (Lib_RE), Loc),
632                Parameter_Associations => New_List (
633                  Relocate_Node (Strm))));
634
635          Set_Do_Range_Check (Res);
636          if Base_Type (P_Type) /= Base_Type (U_Type) then
637             Res := Unchecked_Convert_To (Base_Type (P_Type), Res);
638          end if;
639
640          return Res;
641
642       else
643          return
644            Unchecked_Convert_To (P_Type,
645              Make_Function_Call (Loc,
646                Name => New_Occurrence_Of (RTE (Lib_RE), Loc),
647                Parameter_Associations => New_List (
648                  Relocate_Node (Strm))));
649       end if;
650    end Build_Elementary_Input_Call;
651
652    ---------------------------------
653    -- Build_Elementary_Write_Call --
654    ---------------------------------
655
656    function Build_Elementary_Write_Call (N : Node_Id) return Node_Id is
657       Loc     : constant Source_Ptr := Sloc (N);
658       P_Type  : constant Entity_Id  := Entity (Prefix (N));
659       U_Type  : constant Entity_Id  := Underlying_Type (P_Type);
660       Rt_Type : constant Entity_Id  := Root_Type (U_Type);
661       FST     : constant Entity_Id  := First_Subtype (U_Type);
662       Strm    : constant Node_Id    := First (Expressions (N));
663       Item    : constant Node_Id    := Next (Strm);
664       P_Size  : Uint;
665       Lib_RE  : RE_Id;
666       Libent  : Entity_Id;
667
668    begin
669       --  Compute the size of the stream element. This is either the size of
670       --  the first subtype or if given the size of the Stream_Size attribute.
671
672       if Has_Stream_Size_Clause (FST) then
673          P_Size := Static_Integer (Expression (Stream_Size_Clause (FST)));
674       else
675          P_Size := Esize (FST);
676       end if;
677
678       --  Find the routine to be called
679
680       --  Check for First Boolean and Character. These are enumeration types,
681       --  but we treat them specially, since they may require special handling
682       --  in the transfer protocol. However, this special handling only applies
683       --  if they have standard representation, otherwise they are treated like
684       --  any other enumeration type.
685
686       if Rt_Type = Standard_Boolean
687         and then Has_Stream_Standard_Rep (U_Type)
688       then
689          Lib_RE := RE_W_B;
690
691       elsif Rt_Type = Standard_Character
692         and then Has_Stream_Standard_Rep (U_Type)
693       then
694          Lib_RE := RE_W_C;
695
696       elsif Rt_Type = Standard_Wide_Character
697         and then Has_Stream_Standard_Rep (U_Type)
698       then
699          Lib_RE := RE_W_WC;
700
701       elsif Rt_Type = Standard_Wide_Wide_Character
702         and then Has_Stream_Standard_Rep (U_Type)
703       then
704          Lib_RE := RE_W_WWC;
705
706       --  Floating point types
707
708       elsif Is_Floating_Point_Type (U_Type) then
709
710          --  Question: should we use P_Size or Rt_Type to distinguish between
711          --  possible floating point types? If a non-standard size or a stream
712          --  size is specified, then we should certainly use the size. But if
713          --  we have two types the same (notably Short_Float_Size = Float_Size
714          --  which is close to universally true, and Long_Long_Float_Size =
715          --  Long_Float_Size, true on most targets except the x86), then we
716          --  would really rather use the root type, so that if people want to
717          --  fiddle with System.Stream_Attributes to get inter-target portable
718          --  streams, they get the size they expect. Consider in particular the
719          --  case of a stream written on an x86, with 96-bit Long_Long_Float
720          --  being read into a non-x86 target with 64 bit Long_Long_Float. A
721          --  special version of System.Stream_Attributes can deal with this
722          --  provided the proper type is always used.
723
724          --  To deal with these two requirements we add the special checks
725          --  on equal sizes and use the root type to distinguish.
726
727          if P_Size <= Standard_Short_Float_Size
728            and then (Standard_Short_Float_Size /= Standard_Float_Size
729                       or else Rt_Type = Standard_Short_Float)
730          then
731             Lib_RE := RE_W_SF;
732
733          elsif P_Size <= Standard_Float_Size then
734             Lib_RE := RE_W_F;
735
736          elsif P_Size <= Standard_Long_Float_Size
737            and then (Standard_Long_Float_Size /= Standard_Long_Long_Float_Size
738                       or else Rt_Type = Standard_Float)
739          then
740             Lib_RE := RE_W_LF;
741
742          else
743             Lib_RE := RE_W_LLF;
744          end if;
745
746       --  Signed integer types. Also includes signed fixed-point types and
747       --  signed enumeration types share this circuitry.
748
749       --  Note on signed integer types. We do not consider types as signed for
750       --  this purpose if they have no negative numbers, or if they have biased
751       --  representation. The reason is that the value in either case basically
752       --  represents an unsigned value.
753
754       --  For example, consider:
755
756       --     type W is range 0 .. 2**32 - 1;
757       --     for W'Size use 32;
758
759       --  This is a signed type, but the representation is unsigned, and may
760       --  be outside the range of a 32-bit signed integer, so this must be
761       --  treated as 32-bit unsigned.
762
763       --  Similarly, the representation is also unsigned if we have:
764
765       --     type W is range -1 .. +254;
766       --     for W'Size use 8;
767
768       --  forcing a biased and unsigned representation
769
770       elsif not Is_Unsigned_Type (FST)
771         and then
772           (Is_Fixed_Point_Type (U_Type)
773              or else
774            Is_Enumeration_Type (U_Type)
775              or else
776            (Is_Signed_Integer_Type (U_Type)
777               and then not Has_Biased_Representation (FST)))
778       then
779          if P_Size <= Standard_Short_Short_Integer_Size then
780             Lib_RE := RE_W_SSI;
781          elsif P_Size <= Standard_Short_Integer_Size then
782             Lib_RE := RE_W_SI;
783          elsif P_Size <= Standard_Integer_Size then
784             Lib_RE := RE_W_I;
785          elsif P_Size <= Standard_Long_Integer_Size then
786             Lib_RE := RE_W_LI;
787          else
788             Lib_RE := RE_W_LLI;
789          end if;
790
791       --  Unsigned integer types, also includes unsigned fixed-point types
792       --  and unsigned enumeration types (note we know they are unsigned
793       --  because we already tested for signed above).
794
795       --  Also includes signed integer types that are unsigned in the sense
796       --  that they do not include negative numbers. See above for details.
797
798       elsif Is_Modular_Integer_Type    (U_Type)
799         or else Is_Fixed_Point_Type    (U_Type)
800         or else Is_Enumeration_Type    (U_Type)
801         or else Is_Signed_Integer_Type (U_Type)
802       then
803          if P_Size <= Standard_Short_Short_Integer_Size then
804             Lib_RE := RE_W_SSU;
805          elsif P_Size <= Standard_Short_Integer_Size then
806             Lib_RE := RE_W_SU;
807          elsif P_Size <= Standard_Integer_Size then
808             Lib_RE := RE_W_U;
809          elsif P_Size <= Standard_Long_Integer_Size then
810             Lib_RE := RE_W_LU;
811          else
812             Lib_RE := RE_W_LLU;
813          end if;
814
815       else pragma Assert (Is_Access_Type (U_Type));
816
817          if P_Size > System_Address_Size then
818             Lib_RE := RE_W_AD;
819          else
820             Lib_RE := RE_W_AS;
821          end if;
822       end if;
823
824       --  Unchecked-convert parameter to the required type (i.e. the type of
825       --  the corresponding parameter, and call the appropriate routine.
826
827       Libent := RTE (Lib_RE);
828
829       return
830         Make_Procedure_Call_Statement (Loc,
831           Name => New_Occurrence_Of (Libent, Loc),
832           Parameter_Associations => New_List (
833             Relocate_Node (Strm),
834             Unchecked_Convert_To (Etype (Next_Formal (First_Formal (Libent))),
835               Relocate_Node (Item))));
836    end Build_Elementary_Write_Call;
837
838    -----------------------------------------
839    -- Build_Mutable_Record_Read_Procedure --
840    -----------------------------------------
841
842    procedure Build_Mutable_Record_Read_Procedure
843      (Loc  : Source_Ptr;
844       Typ  : Entity_Id;
845       Decl : out Node_Id;
846       Pnam : out Entity_Id)
847    is
848       Out_Formal : Node_Id;
849       --  Expression denoting the out formal parameter
850
851       Dcls : constant List_Id := New_List;
852       --  Declarations for the 'Read body
853
854       Stms : List_Id := New_List;
855       --  Statements for the 'Read body
856
857       Disc : Entity_Id;
858       --  Entity of the discriminant being processed
859
860       Tmp_For_Disc : Entity_Id;
861       --  Temporary object used to read the value of Disc
862
863       Tmps_For_Discs : constant List_Id := New_List;
864       --  List of object declarations for temporaries holding the read values
865       --  for the discriminants.
866
867       Cstr : constant List_Id := New_List;
868       --  List of constraints to be applied on temporary record
869
870       Discriminant_Checks : constant List_Id := New_List;
871       --  List of discriminant checks to be performed if the actual object
872       --  is constrained.
873
874       Tmp : constant Entity_Id := Make_Defining_Identifier (Loc, Name_V);
875       --  Temporary record must hide formal (assignments to components of the
876       --  record are always generated with V as the identifier for the record).
877
878       Constrained_Stms : List_Id := New_List;
879       --  Statements within the block where we have the constrained temporary
880
881    begin
882
883       Disc := First_Discriminant (Typ);
884
885       --  A mutable type cannot be a tagged type, so we generate a new name
886       --  for the stream procedure.
887
888       Pnam :=
889         Make_Defining_Identifier (Loc,
890           Chars => Make_TSS_Name_Local (Typ, TSS_Stream_Read));
891
892       Out_Formal :=
893         Make_Selected_Component (Loc,
894           Prefix => New_Occurrence_Of (Pnam, Loc),
895           Selector_Name => Make_Identifier (Loc, Name_V));
896
897       --  Generate Reads for the discriminants of the type. The discriminants
898       --  need to be read before the rest of the components, so that
899       --  variants are initialized correctly. The discriminants must be read
900       --  into temporary variables so an incomplete Read (interrupted by an
901       --  exception, for example) does not alter the passed object.
902
903       while Present (Disc) loop
904          Tmp_For_Disc := Make_Defining_Identifier (Loc,
905                            New_External_Name (Chars (Disc), "D"));
906
907          Append_To (Tmps_For_Discs,
908            Make_Object_Declaration (Loc,
909              Defining_Identifier => Tmp_For_Disc,
910              Object_Definition   => New_Occurrence_Of (Etype (Disc), Loc)));
911          Set_No_Initialization (Last (Tmps_For_Discs));
912
913          Append_To (Stms,
914            Make_Attribute_Reference (Loc,
915              Prefix => New_Occurrence_Of (Etype (Disc), Loc),
916              Attribute_Name => Name_Read,
917              Expressions => New_List (
918                Make_Identifier (Loc, Name_S),
919                New_Occurrence_Of (Tmp_For_Disc, Loc))));
920
921          Append_To (Cstr,
922            Make_Discriminant_Association (Loc,
923              Selector_Names => New_List (New_Occurrence_Of (Disc, Loc)),
924              Expression     => New_Occurrence_Of (Tmp_For_Disc, Loc)));
925
926          Append_To (Discriminant_Checks,
927            Make_Raise_Constraint_Error (Loc,
928              Condition =>
929                Make_Op_Ne (Loc,
930                  Left_Opnd  => New_Occurrence_Of (Tmp_For_Disc, Loc),
931                  Right_Opnd =>
932                    Make_Selected_Component (Loc,
933                      Prefix => New_Copy_Tree (Out_Formal),
934                      Selector_Name => New_Occurrence_Of (Disc, Loc))),
935              Reason => CE_Discriminant_Check_Failed));
936          Next_Discriminant (Disc);
937       end loop;
938
939       --  Generate reads for the components of the record (including
940       --  those that depend on discriminants).
941
942       Build_Record_Read_Write_Procedure (Loc, Typ, Decl, Pnam, Name_Read);
943
944       --  If Typ has controlled components (i.e. if it is classwide
945       --  or Has_Controlled), or components constrained using the discriminants
946       --  of Typ, then we need to ensure that all component assignments
947       --  are performed on an object that has been appropriately constrained
948       --  prior to being initialized. To this effect, we wrap the component
949       --  assignments in a block where V is a constrained temporary.
950
951       Append_To (Dcls,
952         Make_Object_Declaration (Loc,
953           Defining_Identifier => Tmp,
954           Object_Definition   =>
955             Make_Subtype_Indication (Loc,
956               Subtype_Mark => New_Occurrence_Of (Typ, Loc),
957               Constraint =>
958                 Make_Index_Or_Discriminant_Constraint (Loc,
959                   Constraints => Cstr))));
960
961       Constrained_Stms := Statements (Handled_Statement_Sequence (Decl));
962       Append_To (Stms,
963         Make_Block_Statement (Loc,
964           Declarations => Dcls,
965           Handled_Statement_Sequence => Parent (Constrained_Stms)));
966
967       Append_To (Constrained_Stms,
968         Make_Implicit_If_Statement (Pnam,
969           Condition =>
970             Make_Attribute_Reference (Loc,
971               Prefix => New_Copy_Tree (Out_Formal),
972               Attribute_Name => Name_Constrained),
973           Then_Statements => Discriminant_Checks));
974
975       Append_To (Constrained_Stms,
976         Make_Assignment_Statement (Loc,
977           Name => Out_Formal,
978           Expression => Make_Identifier (Loc, Name_V)));
979
980       if Is_Unchecked_Union (Typ) then
981
982          --  If this is an unchecked union, the stream procedure is erroneous,
983          --  because there are no discriminants to read.
984
985          --  This should generate a warning ???
986
987          Stms :=
988            New_List (
989              Make_Raise_Program_Error (Loc,
990                Reason => PE_Unchecked_Union_Restriction));
991       end if;
992
993       Set_Declarations (Decl, Tmps_For_Discs);
994       Set_Handled_Statement_Sequence (Decl,
995         Make_Handled_Sequence_Of_Statements (Loc,
996           Statements => Stms));
997    end Build_Mutable_Record_Read_Procedure;
998
999    ------------------------------------------
1000    -- Build_Mutable_Record_Write_Procedure --
1001    ------------------------------------------
1002
1003    procedure Build_Mutable_Record_Write_Procedure
1004      (Loc  : Source_Ptr;
1005       Typ  : Entity_Id;
1006       Decl : out Node_Id;
1007       Pnam : out Entity_Id)
1008    is
1009       Stms  : List_Id;
1010       Disc  : Entity_Id;
1011       D_Ref : Node_Id;
1012
1013    begin
1014       Stms := New_List;
1015       Disc := First_Discriminant (Typ);
1016
1017       --  Generate Writes for the discriminants of the type
1018       --  If the type is an unchecked union, use the default values of
1019       --  the discriminants, because they are not stored.
1020
1021       while Present (Disc) loop
1022          if Is_Unchecked_Union (Typ) then
1023             D_Ref :=
1024                New_Copy_Tree (Discriminant_Default_Value (Disc));
1025          else
1026             D_Ref :=
1027               Make_Selected_Component (Loc,
1028                 Prefix => Make_Identifier (Loc, Name_V),
1029                 Selector_Name => New_Occurrence_Of (Disc, Loc));
1030          end if;
1031
1032          Append_To (Stms,
1033            Make_Attribute_Reference (Loc,
1034              Prefix => New_Occurrence_Of (Etype (Disc), Loc),
1035                Attribute_Name => Name_Write,
1036                Expressions => New_List (
1037                  Make_Identifier (Loc, Name_S),
1038                  D_Ref)));
1039
1040          Next_Discriminant (Disc);
1041       end loop;
1042
1043       --  A mutable type cannot be a tagged type, so we generate a new name
1044       --  for the stream procedure.
1045
1046       Pnam :=
1047         Make_Defining_Identifier (Loc,
1048           Chars => Make_TSS_Name_Local (Typ, TSS_Stream_Write));
1049       Build_Record_Read_Write_Procedure (Loc, Typ, Decl, Pnam, Name_Write);
1050
1051       --  Write the discriminants before the rest of the components, so
1052       --  that discriminant values are properly set of variants, etc.
1053
1054       if Is_Non_Empty_List (
1055         Statements (Handled_Statement_Sequence (Decl)))
1056       then
1057          Insert_List_Before
1058             (First (Statements (Handled_Statement_Sequence (Decl))), Stms);
1059       else
1060          Set_Statements (Handled_Statement_Sequence (Decl), Stms);
1061       end if;
1062    end Build_Mutable_Record_Write_Procedure;
1063
1064    -----------------------------------------------
1065    -- Build_Record_Or_Elementary_Input_Function --
1066    -----------------------------------------------
1067
1068    --  The function we build looks like
1069
1070    --    function InputN (S : access RST) return Typ is
1071    --      C1 : constant Disc_Type_1;
1072    --      Discr_Type_1'Read (S, C1);
1073    --      C2 : constant Disc_Type_2;
1074    --      Discr_Type_2'Read (S, C2);
1075    --      ...
1076    --      Cn : constant Disc_Type_n;
1077    --      Discr_Type_n'Read (S, Cn);
1078    --      V : Typ (C1, C2, .. Cn)
1079
1080    --    begin
1081    --      Typ'Read (S, V);
1082    --      return V;
1083    --    end InputN
1084
1085    --  The discriminants are of course only present in the case of a record
1086    --  with discriminants. In the case of a record with no discriminants, or
1087    --  an elementary type, then no Cn constants are defined.
1088
1089    procedure Build_Record_Or_Elementary_Input_Function
1090      (Loc  : Source_Ptr;
1091       Typ  : Entity_Id;
1092       Decl : out Node_Id;
1093       Fnam : out Entity_Id)
1094    is
1095       Cn     : Name_Id;
1096       J      : Pos;
1097       Decls  : List_Id;
1098       Constr : List_Id;
1099       Stms   : List_Id;
1100       Discr  : Entity_Id;
1101       Odef   : Node_Id;
1102
1103    begin
1104       Decls  := New_List;
1105       Constr := New_List;
1106
1107       J := 1;
1108
1109       if Has_Discriminants (Typ) then
1110          Discr := First_Discriminant (Typ);
1111
1112          while Present (Discr) loop
1113             Cn := New_External_Name ('C', J);
1114
1115             Append_To (Decls,
1116               Make_Object_Declaration (Loc,
1117                 Defining_Identifier => Make_Defining_Identifier (Loc, Cn),
1118                 Object_Definition =>
1119                  New_Occurrence_Of (Etype (Discr), Loc)));
1120
1121             Append_To (Decls,
1122               Make_Attribute_Reference (Loc,
1123                 Prefix => New_Occurrence_Of (Etype (Discr), Loc),
1124                 Attribute_Name => Name_Read,
1125                 Expressions => New_List (
1126                   Make_Identifier (Loc, Name_S),
1127                   Make_Identifier (Loc, Cn))));
1128
1129             Append_To (Constr, Make_Identifier (Loc, Cn));
1130
1131             Next_Discriminant (Discr);
1132             J := J + 1;
1133          end loop;
1134
1135          Odef :=
1136            Make_Subtype_Indication (Loc,
1137              Subtype_Mark => New_Occurrence_Of (Typ, Loc),
1138              Constraint =>
1139                Make_Index_Or_Discriminant_Constraint (Loc,
1140                  Constraints => Constr));
1141
1142       --  If no discriminants, then just use the type with no constraint
1143
1144       else
1145          Odef := New_Occurrence_Of (Typ, Loc);
1146       end if;
1147
1148       Append_To (Decls,
1149         Make_Object_Declaration (Loc,
1150           Defining_Identifier => Make_Defining_Identifier (Loc, Name_V),
1151           Object_Definition => Odef));
1152
1153       Stms := New_List (
1154          Make_Attribute_Reference (Loc,
1155            Prefix => New_Occurrence_Of (Typ, Loc),
1156            Attribute_Name => Name_Read,
1157            Expressions => New_List (
1158              Make_Identifier (Loc, Name_S),
1159              Make_Identifier (Loc, Name_V))),
1160
1161          Make_Return_Statement (Loc,
1162            Expression => Make_Identifier (Loc, Name_V)));
1163
1164       Fnam := Make_Stream_Subprogram_Name (Loc, Typ, TSS_Stream_Input);
1165
1166       Build_Stream_Function (Loc, Typ, Decl, Fnam, Decls, Stms);
1167    end Build_Record_Or_Elementary_Input_Function;
1168
1169    -------------------------------------------------
1170    -- Build_Record_Or_Elementary_Output_Procedure --
1171    -------------------------------------------------
1172
1173    procedure Build_Record_Or_Elementary_Output_Procedure
1174      (Loc  : Source_Ptr;
1175       Typ  : Entity_Id;
1176       Decl : out Node_Id;
1177       Pnam : out Entity_Id)
1178    is
1179       Stms     : List_Id;
1180       Disc     : Entity_Id;
1181       Disc_Ref : Node_Id;
1182
1183    begin
1184       Stms := New_List;
1185
1186       --  Note that of course there will be no discriminants for the
1187       --  elementary type case, so Has_Discriminants will be False.
1188
1189       if Has_Discriminants (Typ) then
1190          Disc := First_Discriminant (Typ);
1191
1192          while Present (Disc) loop
1193
1194             --  If the type is an unchecked union, it must have default
1195             --  discriminants (this is checked earlier), and those defaults
1196             --  are written out to the stream.
1197
1198             if Is_Unchecked_Union (Typ) then
1199                Disc_Ref := New_Copy_Tree (Discriminant_Default_Value (Disc));
1200
1201             else
1202                Disc_Ref :=
1203                  Make_Selected_Component (Loc,
1204                    Prefix => Make_Identifier (Loc, Name_V),
1205                    Selector_Name => New_Occurrence_Of (Disc, Loc));
1206             end if;
1207
1208             Append_To (Stms,
1209               Make_Attribute_Reference (Loc,
1210                 Prefix =>
1211                   New_Occurrence_Of (Stream_Base_Type (Etype (Disc)), Loc),
1212                 Attribute_Name => Name_Write,
1213                 Expressions => New_List (
1214                   Make_Identifier (Loc, Name_S),
1215                   Disc_Ref)));
1216
1217             Next_Discriminant (Disc);
1218          end loop;
1219       end if;
1220
1221       Append_To (Stms,
1222         Make_Attribute_Reference (Loc,
1223           Prefix => New_Occurrence_Of (Typ, Loc),
1224           Attribute_Name => Name_Write,
1225           Expressions => New_List (
1226             Make_Identifier (Loc, Name_S),
1227             Make_Identifier (Loc, Name_V))));
1228
1229       Pnam := Make_Stream_Subprogram_Name (Loc, Typ, TSS_Stream_Output);
1230
1231       Build_Stream_Procedure (Loc, Typ, Decl, Pnam, Stms, False);
1232    end Build_Record_Or_Elementary_Output_Procedure;
1233
1234    ---------------------------------
1235    -- Build_Record_Read_Procedure --
1236    ---------------------------------
1237
1238    procedure Build_Record_Read_Procedure
1239      (Loc  : Source_Ptr;
1240       Typ  : Entity_Id;
1241       Decl : out Node_Id;
1242       Pnam : out Entity_Id)
1243    is
1244    begin
1245       Pnam := Make_Stream_Subprogram_Name (Loc, Typ, TSS_Stream_Read);
1246       Build_Record_Read_Write_Procedure (Loc, Typ, Decl, Pnam, Name_Read);
1247    end Build_Record_Read_Procedure;
1248
1249    ---------------------------------------
1250    -- Build_Record_Read_Write_Procedure --
1251    ---------------------------------------
1252
1253    --  The form of the record read/write procedure is as shown by the
1254    --  following example for a case with one discriminant case variant:
1255
1256    --    procedure pnam (S : access RST, V : [out] Typ) is
1257    --    begin
1258    --       Component_Type'Read/Write (S, V.component);
1259    --       Component_Type'Read/Write (S, V.component);
1260    --       ...
1261    --       Component_Type'Read/Write (S, V.component);
1262    --
1263    --       case V.discriminant is
1264    --          when choices =>
1265    --             Component_Type'Read/Write (S, V.component);
1266    --             Component_Type'Read/Write (S, V.component);
1267    --             ...
1268    --             Component_Type'Read/Write (S, V.component);
1269    --
1270    --          when choices =>
1271    --             Component_Type'Read/Write (S, V.component);
1272    --             Component_Type'Read/Write (S, V.component);
1273    --             ...
1274    --             Component_Type'Read/Write (S, V.component);
1275    --          ...
1276    --       end case;
1277    --    end pnam;
1278
1279    --  The out keyword for V is supplied in the Read case
1280
1281    procedure Build_Record_Read_Write_Procedure
1282      (Loc  : Source_Ptr;
1283       Typ  : Entity_Id;
1284       Decl : out Node_Id;
1285       Pnam : Entity_Id;
1286       Nam  : Name_Id)
1287    is
1288       Rdef : Node_Id;
1289       Stms : List_Id;
1290       Typt : Entity_Id;
1291
1292       In_Limited_Extension : Boolean := False;
1293       --  Set to True while processing the record extension definition
1294       --  for an extension of a limited type (for which an ancestor type
1295       --  has an explicit Nam attribute definition).
1296
1297       function Make_Component_List_Attributes (CL : Node_Id) return List_Id;
1298       --  Returns a sequence of attributes to process the components that
1299       --  are referenced in the given component list.
1300
1301       function Make_Field_Attribute (C : Entity_Id) return Node_Id;
1302       --  Given C, the entity for a discriminant or component, build
1303       --  an attribute for the corresponding field values.
1304
1305       function Make_Field_Attributes (Clist : List_Id) return List_Id;
1306       --  Given Clist, a component items list, construct series of attributes
1307       --  for fieldwise processing of the corresponding components.
1308
1309       ------------------------------------
1310       -- Make_Component_List_Attributes --
1311       ------------------------------------
1312
1313       function Make_Component_List_Attributes (CL : Node_Id) return List_Id is
1314          CI : constant List_Id := Component_Items (CL);
1315          VP : constant Node_Id := Variant_Part (CL);
1316
1317          Result : List_Id;
1318          Alts   : List_Id;
1319          V      : Node_Id;
1320          DC     : Node_Id;
1321          DCH    : List_Id;
1322          D_Ref  : Node_Id;
1323
1324       begin
1325          Result := Make_Field_Attributes (CI);
1326
1327          if Present (VP) then
1328             Alts := New_List;
1329
1330             V := First_Non_Pragma (Variants (VP));
1331             while Present (V) loop
1332                DCH := New_List;
1333
1334                DC := First (Discrete_Choices (V));
1335                while Present (DC) loop
1336                   Append_To (DCH, New_Copy_Tree (DC));
1337                   Next (DC);
1338                end loop;
1339
1340                Append_To (Alts,
1341                  Make_Case_Statement_Alternative (Loc,
1342                    Discrete_Choices => DCH,
1343                    Statements =>
1344                      Make_Component_List_Attributes (Component_List (V))));
1345                Next_Non_Pragma (V);
1346             end loop;
1347
1348             --  Note: in the following, we make sure that we use new occurrence
1349             --  of for the selector, since there are cases in which we make a
1350             --  reference to a hidden discriminant that is not visible.
1351
1352             --  If the enclosing record is an unchecked_union, we use the
1353             --  default expressions for the discriminant (it must exist)
1354             --  because we cannot generate a reference to it, given that
1355             --  it is not stored..
1356
1357             if Is_Unchecked_Union (Scope (Entity (Name (VP)))) then
1358                D_Ref :=
1359                  New_Copy_Tree
1360                    (Discriminant_Default_Value (Entity (Name (VP))));
1361             else
1362                D_Ref :=
1363                   Make_Selected_Component (Loc,
1364                     Prefix => Make_Identifier (Loc, Name_V),
1365                     Selector_Name =>
1366                       New_Occurrence_Of (Entity (Name (VP)), Loc));
1367             end if;
1368
1369             Append_To (Result,
1370               Make_Case_Statement (Loc,
1371                 Expression => D_Ref,
1372                 Alternatives => Alts));
1373          end if;
1374
1375          return Result;
1376       end Make_Component_List_Attributes;
1377
1378       --------------------------
1379       -- Make_Field_Attribute --
1380       --------------------------
1381
1382       function Make_Field_Attribute (C : Entity_Id) return Node_Id is
1383          Field_Typ : constant Entity_Id := Stream_Base_Type (Etype (C));
1384
1385          TSS_Names : constant array (Name_Input .. Name_Write) of
1386                        TSS_Name_Type :=
1387                         (Name_Read   => TSS_Stream_Read,
1388                          Name_Write  => TSS_Stream_Write,
1389                          Name_Input  => TSS_Stream_Input,
1390                          Name_Output => TSS_Stream_Output,
1391                          others      => TSS_Null);
1392          pragma Assert (TSS_Names (Nam) /= TSS_Null);
1393
1394       begin
1395          if In_Limited_Extension
1396            and then Is_Limited_Type (Field_Typ)
1397            and then No (Find_Inherited_TSS (Field_Typ, TSS_Names (Nam)))
1398          then
1399             --  The declaration is illegal per 13.13.2(9/1), and this is
1400             --  enforced in Exp_Ch3.Check_Stream_Attributes. Keep the caller
1401             --  happy by returning a null statement.
1402
1403             return Make_Null_Statement (Loc);
1404          end if;
1405
1406          return
1407            Make_Attribute_Reference (Loc,
1408              Prefix =>
1409                New_Occurrence_Of (Field_Typ, Loc),
1410              Attribute_Name => Nam,
1411              Expressions => New_List (
1412                Make_Identifier (Loc, Name_S),
1413                Make_Selected_Component (Loc,
1414                  Prefix => Make_Identifier (Loc, Name_V),
1415                  Selector_Name => New_Occurrence_Of (C, Loc))));
1416       end Make_Field_Attribute;
1417
1418       ---------------------------
1419       -- Make_Field_Attributes --
1420       ---------------------------
1421
1422       function Make_Field_Attributes (Clist : List_Id) return List_Id is
1423          Item   : Node_Id;
1424          Result : List_Id;
1425
1426       begin
1427          Result := New_List;
1428
1429          if Present (Clist) then
1430             Item := First (Clist);
1431
1432             --  Loop through components, skipping all internal components,
1433             --  which are not part of the value (e.g. _Tag), except that we
1434             --  don't skip the _Parent, since we do want to process that
1435             --  recursively. If _Parent is an interface type, being abstract
1436             --  with no components there is no need to handle it.
1437
1438             while Present (Item) loop
1439                if Nkind (Item) = N_Component_Declaration
1440                  and then
1441                    ((Chars (Defining_Identifier (Item)) = Name_uParent
1442                        and then not Is_Interface
1443                                       (Etype (Defining_Identifier (Item))))
1444                      or else
1445                     not Is_Internal_Name (Chars (Defining_Identifier (Item))))
1446                then
1447                   Append_To
1448                     (Result,
1449                      Make_Field_Attribute (Defining_Identifier (Item)));
1450                end if;
1451
1452                Next (Item);
1453             end loop;
1454          end if;
1455
1456          return Result;
1457       end Make_Field_Attributes;
1458
1459    --  Start of processing for Build_Record_Read_Write_Procedure
1460
1461    begin
1462       --  For the protected type case, use corresponding record
1463
1464       if Is_Protected_Type (Typ) then
1465          Typt := Corresponding_Record_Type (Typ);
1466       else
1467          Typt := Typ;
1468       end if;
1469
1470       --  Note that we do nothing with the discriminants, since Read and
1471       --  Write do not read or write the discriminant values. All handling
1472       --  of discriminants occurs in the Input and Output subprograms.
1473
1474       Rdef := Type_Definition
1475                 (Declaration_Node (Base_Type (Underlying_Type (Typt))));
1476       Stms := Empty_List;
1477
1478       --  In record extension case, the fields we want, including the _Parent
1479       --  field representing the parent type, are to be found in the extension.
1480       --  Note that we will naturally process the _Parent field using the type
1481       --  of the parent, and hence its stream attributes, which is appropriate.
1482
1483       if Nkind (Rdef) = N_Derived_Type_Definition then
1484          Rdef := Record_Extension_Part (Rdef);
1485
1486          if Is_Limited_Type (Typt) then
1487             In_Limited_Extension := True;
1488          end if;
1489       end if;
1490
1491       if Present (Component_List (Rdef)) then
1492          Append_List_To (Stms,
1493            Make_Component_List_Attributes (Component_List (Rdef)));
1494       end if;
1495
1496       Build_Stream_Procedure
1497         (Loc, Typ, Decl, Pnam, Stms, Nam = Name_Read);
1498    end Build_Record_Read_Write_Procedure;
1499
1500    ----------------------------------
1501    -- Build_Record_Write_Procedure --
1502    ----------------------------------
1503
1504    procedure Build_Record_Write_Procedure
1505      (Loc  : Source_Ptr;
1506       Typ  : Entity_Id;
1507       Decl : out Node_Id;
1508       Pnam : out Entity_Id)
1509    is
1510    begin
1511       Pnam := Make_Stream_Subprogram_Name (Loc, Typ, TSS_Stream_Write);
1512       Build_Record_Read_Write_Procedure (Loc, Typ, Decl, Pnam, Name_Write);
1513    end Build_Record_Write_Procedure;
1514
1515    -------------------------------
1516    -- Build_Stream_Attr_Profile --
1517    -------------------------------
1518
1519    function Build_Stream_Attr_Profile
1520      (Loc : Source_Ptr;
1521       Typ : Entity_Id;
1522       Nam : TSS_Name_Type) return List_Id
1523    is
1524       Profile : List_Id;
1525
1526    begin
1527       --  (Ada 2005: AI-441): Set the null-excluding attribute because it has
1528       --  no semantic meaning in Ada 95 but it is a requirement in Ada2005.
1529
1530       Profile := New_List (
1531         Make_Parameter_Specification (Loc,
1532           Defining_Identifier => Make_Defining_Identifier (Loc, Name_S),
1533           Parameter_Type      =>
1534           Make_Access_Definition (Loc,
1535              Null_Exclusion_Present => True,
1536              Subtype_Mark => New_Reference_To (
1537                Class_Wide_Type (RTE (RE_Root_Stream_Type)), Loc))));
1538
1539       if Nam /= TSS_Stream_Input then
1540          Append_To (Profile,
1541            Make_Parameter_Specification (Loc,
1542              Defining_Identifier => Make_Defining_Identifier (Loc, Name_V),
1543              Out_Present         => (Nam = TSS_Stream_Read),
1544              Parameter_Type      => New_Reference_To (Typ, Loc)));
1545       end if;
1546
1547       return Profile;
1548    end Build_Stream_Attr_Profile;
1549
1550    ---------------------------
1551    -- Build_Stream_Function --
1552    ---------------------------
1553
1554    procedure Build_Stream_Function
1555      (Loc   : Source_Ptr;
1556       Typ   : Entity_Id;
1557       Decl  : out Node_Id;
1558       Fnam  : Entity_Id;
1559       Decls : List_Id;
1560       Stms  : List_Id)
1561    is
1562       Spec : Node_Id;
1563
1564    begin
1565       --  Construct function specification
1566
1567       --  (Ada 2005: AI-441): Set the null-excluding attribute because it has
1568       --  no semantic meaning in Ada 95 but it is a requirement in Ada2005.
1569
1570       Spec :=
1571         Make_Function_Specification (Loc,
1572           Defining_Unit_Name => Fnam,
1573
1574           Parameter_Specifications => New_List (
1575             Make_Parameter_Specification (Loc,
1576               Defining_Identifier => Make_Defining_Identifier (Loc, Name_S),
1577               Parameter_Type =>
1578                 Make_Access_Definition (Loc,
1579                   Null_Exclusion_Present => True,
1580                   Subtype_Mark => New_Reference_To (
1581                     Class_Wide_Type (RTE (RE_Root_Stream_Type)), Loc)))),
1582
1583           Result_Definition => New_Occurrence_Of (Typ, Loc));
1584
1585       Decl :=
1586         Make_Subprogram_Body (Loc,
1587           Specification => Spec,
1588           Declarations => Decls,
1589           Handled_Statement_Sequence =>
1590             Make_Handled_Sequence_Of_Statements (Loc,
1591               Statements => Stms));
1592    end Build_Stream_Function;
1593
1594    ----------------------------
1595    -- Build_Stream_Procedure --
1596    ----------------------------
1597
1598    procedure Build_Stream_Procedure
1599      (Loc  : Source_Ptr;
1600       Typ  : Entity_Id;
1601       Decl : out Node_Id;
1602       Pnam : Entity_Id;
1603       Stms : List_Id;
1604       Outp : Boolean)
1605    is
1606       Spec : Node_Id;
1607
1608    begin
1609       --  Construct procedure specification
1610
1611       --  (Ada 2005: AI-441): Set the null-excluding attribute because it has
1612       --  no semantic meaning in Ada 95 but it is a requirement in Ada2005.
1613
1614       Spec :=
1615         Make_Procedure_Specification (Loc,
1616           Defining_Unit_Name => Pnam,
1617
1618           Parameter_Specifications => New_List (
1619             Make_Parameter_Specification (Loc,
1620               Defining_Identifier => Make_Defining_Identifier (Loc, Name_S),
1621               Parameter_Type =>
1622                 Make_Access_Definition (Loc,
1623                   Null_Exclusion_Present => True,
1624                   Subtype_Mark => New_Reference_To (
1625                     Class_Wide_Type (RTE (RE_Root_Stream_Type)), Loc))),
1626
1627             Make_Parameter_Specification (Loc,
1628               Defining_Identifier => Make_Defining_Identifier (Loc, Name_V),
1629               Out_Present         => Outp,
1630               Parameter_Type      => New_Occurrence_Of (Typ, Loc))));
1631
1632       Decl :=
1633         Make_Subprogram_Body (Loc,
1634           Specification => Spec,
1635           Declarations => Empty_List,
1636           Handled_Statement_Sequence =>
1637             Make_Handled_Sequence_Of_Statements (Loc,
1638               Statements => Stms));
1639    end Build_Stream_Procedure;
1640
1641    -----------------------------
1642    -- Has_Stream_Standard_Rep --
1643    -----------------------------
1644
1645    function Has_Stream_Standard_Rep (U_Type : Entity_Id) return Boolean is
1646       Siz : Uint;
1647
1648    begin
1649       if Has_Non_Standard_Rep (U_Type) then
1650          return False;
1651       end if;
1652
1653       if Has_Stream_Size_Clause (U_Type) then
1654          Siz := Static_Integer (Expression (Stream_Size_Clause (U_Type)));
1655       else
1656          Siz := Esize (First_Subtype (U_Type));
1657       end if;
1658
1659       return Siz = Esize (Root_Type (U_Type));
1660    end Has_Stream_Standard_Rep;
1661
1662    ---------------------------------
1663    -- Make_Stream_Subprogram_Name --
1664    ---------------------------------
1665
1666    function Make_Stream_Subprogram_Name
1667      (Loc : Source_Ptr;
1668       Typ : Entity_Id;
1669       Nam : TSS_Name_Type) return Entity_Id
1670    is
1671       Sname : Name_Id;
1672
1673    begin
1674       --  For tagged types, we are dealing with a TSS associated with the
1675       --  declaration, so we use the standard primitive function name. For
1676       --  other types, generate a local TSS name since we are generating
1677       --  the subprogram at the point of use.
1678
1679       if Is_Tagged_Type (Typ) then
1680          Sname := Make_TSS_Name (Typ, Nam);
1681       else
1682          Sname := Make_TSS_Name_Local (Typ, Nam);
1683       end if;
1684
1685       return Make_Defining_Identifier (Loc, Sname);
1686    end Make_Stream_Subprogram_Name;
1687
1688    ----------------------
1689    -- Stream_Base_Type --
1690    ----------------------
1691
1692    function Stream_Base_Type (E : Entity_Id) return Entity_Id is
1693    begin
1694       if Is_Array_Type (E)
1695         and then Is_First_Subtype (E)
1696       then
1697          return E;
1698       else
1699          return Base_Type (E);
1700       end if;
1701    end Stream_Base_Type;
1702
1703 end Exp_Strm;