1 ------------------------------------------------------------------------------
3 -- GNAT COMPILER COMPONENTS --
9 -- Copyright (C) 1999-2023, 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 ------------------------------------------------------------------------------
27 with Atree
; use Atree
;
28 with Casing
; use Casing
;
29 with Debug
; use Debug
;
30 with Einfo
; use Einfo
;
31 with Einfo
.Entities
; use Einfo
.Entities
;
32 with Einfo
.Utils
; use Einfo
.Utils
;
34 with Namet
; use Namet
;
35 with Nlists
; use Nlists
;
37 with Output
; use Output
;
38 with Osint
.C
; use Osint
.C
;
39 with Sem_Aux
; use Sem_Aux
;
40 with Sem_Eval
; use Sem_Eval
;
42 with Sinfo
; use Sinfo
;
43 with Sinfo
.Nodes
; use Sinfo
.Nodes
;
44 with Sinfo
.Utils
; use Sinfo
.Utils
;
45 with Sinput
; use Sinput
;
46 with Snames
; use Snames
;
47 with Stand
; use Stand
;
48 with Stringt
; use Stringt
;
51 with Uname
; use Uname
;
52 with Urealp
; use Urealp
;
54 with Ada
.Unchecked_Conversion
;
58 package body Repinfo
is
60 SSU
: Pos
renames Ttypes
.System_Storage_Unit
;
61 -- Value for Storage_Unit
63 ---------------------------------------
64 -- Representation of GCC Expressions --
65 ---------------------------------------
67 -- A table internal to this unit is used to hold the values of back
68 -- annotated expressions.
70 -- Node values are stored as Uint values using the negative of the node
71 -- index in this table. Constants appear as non-negative Uint values.
73 type Exp_Node
is record
75 Op1
: Node_Ref_Or_Val
;
76 Op2
: Node_Ref_Or_Val
;
77 Op3
: Node_Ref_Or_Val
;
80 -- The following representation clause ensures that the above record
81 -- has no holes. We do this so that when instances of this record are
82 -- written, we do not write uninitialized values to the file.
84 for Exp_Node
use record
85 Expr
at 0 range 0 .. 31;
86 Op1
at 4 range 0 .. 31;
87 Op2
at 8 range 0 .. 31;
88 Op3
at 12 range 0 .. 31;
91 for Exp_Node
'Size use 16 * 8;
92 -- This ensures that we did not leave out any fields
94 package Rep_Table
is new Table
.Table
(
95 Table_Component_Type
=> Exp_Node
,
96 Table_Index_Type
=> Nat
,
98 Table_Initial
=> Alloc
.Rep_Table_Initial
,
99 Table_Increment
=> Alloc
.Rep_Table_Increment
,
100 Table_Name
=> "BE_Rep_Table");
102 --------------------------------------------------------------
103 -- Representation of Front-End Dynamic Size/Offset Entities --
104 --------------------------------------------------------------
106 package Dynamic_SO_Entity_Table
is new Table
.Table
(
107 Table_Component_Type
=> Entity_Id
,
108 Table_Index_Type
=> Nat
,
109 Table_Low_Bound
=> 1,
110 Table_Initial
=> Alloc
.Rep_Table_Initial
,
111 Table_Increment
=> Alloc
.Rep_Table_Increment
,
112 Table_Name
=> "FE_Rep_Table");
114 Unit_Casing
: Casing_Type
;
115 -- Identifier casing for current unit. This is set by List_Rep_Info for
116 -- each unit, before calling subprograms which may read it.
118 Need_Separator
: Boolean;
119 -- Set True if a separator is needed before outputting any information for
120 -- the current entity.
122 ------------------------------
123 -- Set of Relevant Entities --
124 ------------------------------
126 Relevant_Entities_Size
: constant := 4093;
127 -- Number of headers in hash table
129 subtype Entity_Header_Num
is Integer range 0 .. Relevant_Entities_Size
- 1;
130 -- Range of headers in hash table
132 function Entity_Hash
(Id
: Entity_Id
) return Entity_Header_Num
;
133 -- Simple hash function for Entity_Ids
135 package Relevant_Entities
is new GNAT
.Htable
.Simple_HTable
136 (Header_Num
=> Entity_Header_Num
,
142 -- Hash table to record which compiler-generated entities are relevant
144 -----------------------
145 -- Local Subprograms --
146 -----------------------
148 procedure List_Entities
150 Bytes_Big_Endian
: Boolean;
151 In_Subprogram
: Boolean := False);
152 -- This procedure lists the entities associated with the entity E, starting
153 -- with the First_Entity and using the Next_Entity link. If a nested
154 -- package is found, entities within the package are recursively processed.
155 -- When recursing within a subprogram body, Is_Subprogram suppresses
156 -- duplicate information about signature.
158 procedure List_Name
(Ent
: Entity_Id
);
159 -- List name of entity Ent in appropriate case. The name is listed with
160 -- full qualification up to but not including the compilation unit name.
162 procedure List_Array_Info
(Ent
: Entity_Id
; Bytes_Big_Endian
: Boolean);
163 -- List representation info for array type Ent
165 procedure List_Common_Type_Info
(Ent
: Entity_Id
);
166 -- List common type info (name, size, alignment) for type Ent
168 procedure List_Linker_Section
(Ent
: Entity_Id
);
169 -- List linker section for Ent (caller has checked that Ent is an entity
170 -- for which the Linker_Section_Pragma field is defined).
172 procedure List_Location
(Ent
: Entity_Id
);
173 -- List location information for Ent
175 procedure List_Object_Info
(Ent
: Entity_Id
);
176 -- List representation info for object Ent
178 procedure List_Record_Info
(Ent
: Entity_Id
; Bytes_Big_Endian
: Boolean);
179 -- List representation info for record type Ent
181 procedure List_Scalar_Storage_Order
183 Bytes_Big_Endian
: Boolean);
184 -- List scalar storage order information for record or array type Ent.
185 -- Also includes bit order information for record types, if necessary.
187 procedure List_Subprogram_Info
(Ent
: Entity_Id
);
188 -- List subprogram info for subprogram Ent
190 procedure List_Type_Info
(Ent
: Entity_Id
);
191 -- List type info for type Ent
193 function Compile_Time_Known_Rep
(Val
: Node_Ref_Or_Val
) return Boolean;
194 -- Returns True if Val represents a representation value that is known at
197 procedure Spaces
(N
: Natural);
198 -- Output given number of spaces
200 procedure Write_Info_Line
(S
: String);
201 -- Routine to write a line to Repinfo output file. This routine is passed
202 -- as a special output procedure to Output.Set_Special_Output. Note that
203 -- Write_Info_Line is called with an EOL character at the end of each line,
204 -- as per the Output spec, but the internal call to the appropriate routine
205 -- in Osint requires that the end of line sequence be stripped off.
207 procedure Write_Mechanism
(M
: Mechanism_Type
);
208 -- Writes symbolic string for mechanism represented by M
210 procedure Write_Separator
;
211 -- Called before outputting anything for an entity. Ensures that
212 -- a separator precedes the output for a particular entity.
214 procedure Write_Unknown_Val
;
215 -- Writes symbolic string for an unknown or non-representable value
217 procedure Write_Val
(Val
: Node_Ref_Or_Val
; Paren
: Boolean := False);
218 -- Given a representation value, write it out. No_Uint values or values
219 -- dependent on discriminants are written as two question marks. If the
220 -- flag Paren is set, then the output is surrounded in parentheses if it is
221 -- other than a simple value.
223 ------------------------
224 -- Create_Discrim_Ref --
225 ------------------------
227 function Create_Discrim_Ref
(Discr
: Entity_Id
) return Node_Ref
is
230 (Expr
=> Discrim_Val
,
231 Op1
=> Discriminant_Number
(Discr
));
232 end Create_Discrim_Ref
;
234 ---------------------------
235 -- Create_Dynamic_SO_Ref --
236 ---------------------------
238 function Create_Dynamic_SO_Ref
(E
: Entity_Id
) return Dynamic_SO_Ref
is
240 Dynamic_SO_Entity_Table
.Append
(E
);
241 return UI_From_Int
(-Dynamic_SO_Entity_Table
.Last
);
242 end Create_Dynamic_SO_Ref
;
250 Op1
: Node_Ref_Or_Val
;
251 Op2
: Node_Ref_Or_Val
:= No_Uint
;
252 Op3
: Node_Ref_Or_Val
:= No_Uint
) return Node_Ref
260 return UI_From_Int
(-Rep_Table
.Last
);
267 function Entity_Hash
(Id
: Entity_Id
) return Entity_Header_Num
is
269 return Entity_Header_Num
(Id
mod Relevant_Entities_Size
);
272 ---------------------------
273 -- Get_Dynamic_SO_Entity --
274 ---------------------------
276 function Get_Dynamic_SO_Entity
(U
: Dynamic_SO_Ref
) return Entity_Id
is
278 return Dynamic_SO_Entity_Table
.Table
(-UI_To_Int
(U
));
279 end Get_Dynamic_SO_Entity
;
281 -----------------------
282 -- Is_Dynamic_SO_Ref --
283 -----------------------
285 function Is_Dynamic_SO_Ref
(U
: SO_Ref
) return Boolean is
288 end Is_Dynamic_SO_Ref
;
290 ----------------------
291 -- Is_Static_SO_Ref --
292 ----------------------
294 function Is_Static_SO_Ref
(U
: SO_Ref
) return Boolean is
297 end Is_Static_SO_Ref
;
303 procedure lgx
(U
: Node_Ref_Or_Val
) is
305 List_GCC_Expression
(U
);
309 ----------------------
310 -- List_Array_Info --
311 ----------------------
313 procedure List_Array_Info
(Ent
: Entity_Id
; Bytes_Big_Endian
: Boolean) is
317 if List_Representation_Info_To_JSON
then
321 List_Common_Type_Info
(Ent
);
323 if List_Representation_Info_To_JSON
then
325 Write_Str
(" ""Component_Size"": ");
326 Write_Val
(Component_Size
(Ent
));
330 Write_Str
("'Component_Size use ");
331 Write_Val
(Component_Size
(Ent
));
335 List_Scalar_Storage_Order
(Ent
, Bytes_Big_Endian
);
337 List_Linker_Section
(Ent
);
339 if List_Representation_Info_To_JSON
then
344 -- The component type is relevant for an array
346 if List_Representation_Info
= 4
347 and then Is_Itype
(Component_Type
(Base_Type
(Ent
)))
349 Relevant_Entities
.Set
(Component_Type
(Base_Type
(Ent
)), True);
353 ---------------------------
354 -- List_Common_Type_Info --
355 ---------------------------
357 procedure List_Common_Type_Info
(Ent
: Entity_Id
) is
359 if List_Representation_Info_To_JSON
then
360 Write_Str
(" ""name"": """);
366 -- Do not list size info for unconstrained arrays, not meaningful
368 if Is_Array_Type
(Ent
) and then not Is_Constrained
(Ent
) then
372 if Known_Esize
(Ent
) and then Known_RM_Size
(Ent
) then
373 -- If Esize and RM_Size are the same, list as Size. This is a
374 -- common case, which we may as well list in simple form.
376 if Esize
(Ent
) = RM_Size
(Ent
) then
377 if List_Representation_Info_To_JSON
then
378 Write_Str
(" ""Size"": ");
379 Write_Val
(Esize
(Ent
));
384 Write_Str
("'Size use ");
385 Write_Val
(Esize
(Ent
));
389 -- Otherwise list size values separately
392 if List_Representation_Info_To_JSON
then
393 Write_Str
(" ""Object_Size"": ");
394 Write_Val
(Esize
(Ent
));
397 Write_Str
(" ""Value_Size"": ");
398 Write_Val
(RM_Size
(Ent
));
404 Write_Str
("'Object_Size use ");
405 Write_Val
(Esize
(Ent
));
410 Write_Str
("'Value_Size use ");
411 Write_Val
(RM_Size
(Ent
));
418 if Known_Alignment
(Ent
) then
419 if List_Representation_Info_To_JSON
then
420 Write_Str
(" ""Alignment"": ");
421 Write_Val
(Alignment
(Ent
));
425 Write_Str
("'Alignment use ");
426 Write_Val
(Alignment
(Ent
));
430 -- Alignment is not always set for task, protected, and class-wide
431 -- types, or when doing semantic analysis only. Representation aspects
432 -- are not computed for types in a generic unit.
435 -- Add unknown alignment entry in JSON format to ensure the format is
436 -- valid, as a comma is added by the caller before another field.
438 if List_Representation_Info_To_JSON
then
439 Write_Str
(" ""Alignment"": ");
444 (not Expander_Active
or else
445 Is_Concurrent_Type
(Ent
) or else
446 Is_Class_Wide_Type
(Ent
) or else
447 Sem_Util
.In_Generic_Scope
(Ent
));
449 end List_Common_Type_Info
;
455 procedure List_Entities
457 Bytes_Big_Endian
: Boolean;
458 In_Subprogram
: Boolean := False)
463 function Find_Declaration
(E
: Entity_Id
) return Node_Id
;
464 -- Utility to retrieve declaration node for entity in the
465 -- case of package bodies and subprograms.
467 ----------------------
468 -- Find_Declaration --
469 ----------------------
471 function Find_Declaration
(E
: Entity_Id
) return Node_Id
is
477 and then Nkind
(Decl
) /= N_Package_Body
478 and then Nkind
(Decl
) /= N_Subprogram_Declaration
479 and then Nkind
(Decl
) /= N_Subprogram_Body
481 Decl
:= Parent
(Decl
);
485 end Find_Declaration
;
487 -- Start of processing for List_Entities
490 -- List entity if we have one, and it is not a renaming declaration.
491 -- For renamings, we don't get proper information, and really it makes
492 -- sense to restrict the output to the renamed entity.
495 and then Nkind
(Declaration_Node
(Ent
)) not in N_Renaming_Declaration
496 and then not Is_Ignored_Ghost_Entity
(Ent
)
498 -- If entity is a subprogram and we are listing mechanisms,
499 -- then we need to list mechanisms for this entity. We skip this
500 -- if it is a nested subprogram, as the information has already
501 -- been produced when listing the enclosing scope.
503 if List_Representation_Info_Mechanisms
504 and then Is_Subprogram_Or_Entry
(Ent
)
505 and then not In_Subprogram
507 List_Subprogram_Info
(Ent
);
510 E
:= First_Entity
(Ent
);
511 while Present
(E
) loop
512 -- We list entities that come from source (excluding private or
513 -- incomplete types or deferred constants, for which we will list
514 -- the information for the full view). If requested, we also list
515 -- relevant entities that have been generated when processing the
516 -- original entities coming from source. But if debug flag A is
517 -- set, then all entities are listed.
519 if ((Comes_From_Source
(E
)
520 or else (Ekind
(E
) = E_Block
522 Nkind
(Parent
(E
)) = N_Implicit_Label_Declaration
524 Comes_From_Source
(Label_Construct
(Parent
(E
)))))
525 and then not Is_Incomplete_Or_Private_Type
(E
)
526 and then not (Ekind
(E
) = E_Constant
527 and then Present
(Full_View
(E
))))
528 or else (List_Representation_Info
= 4
529 and then Relevant_Entities
.Get
(E
))
530 or else Debug_Flag_AA
532 if Is_Subprogram
(E
) then
533 if List_Representation_Info_Mechanisms
then
534 List_Subprogram_Info
(E
);
537 -- Recurse into entities local to subprogram
539 List_Entities
(E
, Bytes_Big_Endian
, True);
541 elsif Ekind
(E
) in E_Entry
545 if List_Representation_Info_Mechanisms
then
546 List_Subprogram_Info
(E
);
549 elsif Is_Record_Type
(E
) then
550 if List_Representation_Info
>= 1 then
551 List_Record_Info
(E
, Bytes_Big_Endian
);
553 -- Recurse into entities local to a record type
555 if List_Representation_Info
= 4 then
556 List_Entities
(E
, Bytes_Big_Endian
, False);
560 elsif Is_Array_Type
(E
) then
561 if List_Representation_Info
>= 1 then
562 List_Array_Info
(E
, Bytes_Big_Endian
);
565 elsif Is_Type
(E
) then
566 if List_Representation_Info
>= 2 then
570 -- Note that formals are not annotated so we skip them here
572 elsif Ekind
(E
) in E_Constant
576 if List_Representation_Info
>= 2 then
577 List_Object_Info
(E
);
581 -- Recurse into nested package, but not child packages, and not
582 -- nested package renamings (in particular renamings of the
583 -- enclosing package, as for some Java bindings and for generic
586 if Ekind
(E
) = E_Package
then
587 if No
(Renamed_Entity
(E
)) and then not Is_Child_Unit
(E
)
589 List_Entities
(E
, Bytes_Big_Endian
);
592 -- Recurse into bodies
594 elsif Ekind
(E
) in E_Package_Body
601 List_Entities
(E
, Bytes_Big_Endian
);
603 -- Recurse into blocks
605 elsif Ekind
(E
) = E_Block
then
606 List_Entities
(E
, Bytes_Big_Endian
);
613 -- For a package body, the entities of the visible subprograms are
614 -- declared in the corresponding spec. Iterate over its entities in
615 -- order to handle properly the subprogram bodies. Skip bodies in
616 -- subunits, which are listed independently.
618 if Ekind
(Ent
) = E_Package_Body
619 and then Present
(Corresponding_Spec
(Find_Declaration
(Ent
)))
621 E
:= First_Entity
(Corresponding_Spec
(Find_Declaration
(Ent
)));
622 while Present
(E
) loop
625 Nkind
(Find_Declaration
(E
)) = N_Subprogram_Declaration
627 Body_E
:= Corresponding_Body
(Find_Declaration
(E
));
631 Nkind
(Parent
(Find_Declaration
(Body_E
))) /= N_Subunit
633 List_Entities
(Body_E
, Bytes_Big_Endian
);
643 -------------------------
644 -- List_GCC_Expression --
645 -------------------------
647 procedure List_GCC_Expression
(U
: Node_Ref_Or_Val
) is
649 procedure Print_Expr
(Val
: Node_Ref_Or_Val
);
650 -- Internal recursive procedure to print expression
656 procedure Print_Expr
(Val
: Node_Ref_Or_Val
) is
659 UI_Write
(Val
, Decimal
);
663 Node
: Exp_Node
renames Rep_Table
.Table
(-UI_To_Int
(Val
));
665 procedure Unop
(S
: String);
666 -- Output text for unary operator with S being operator name
668 procedure Binop
(S
: String);
669 -- Output text for binary operator with S being operator name
675 procedure Unop
(S
: String) is
677 if List_Representation_Info_To_JSON
then
678 Write_Str
("{ ""code"": """);
679 if S
(S
'Last) = ' ' then
680 Write_Str
(S
(S
'First .. S
'Last - 1));
684 Write_Str
(""", ""operands"": [ ");
685 Print_Expr
(Node
.Op1
);
689 Print_Expr
(Node
.Op1
);
697 procedure Binop
(S
: String) is
699 if List_Representation_Info_To_JSON
then
700 Write_Str
("{ ""code"": """);
701 Write_Str
(S
(S
'First + 1 .. S
'Last - 1));
702 Write_Str
(""", ""operands"": [ ");
703 Print_Expr
(Node
.Op1
);
705 Print_Expr
(Node
.Op2
);
709 Print_Expr
(Node
.Op1
);
711 Print_Expr
(Node
.Op2
);
716 -- Start of processing for Print_Expr
721 if List_Representation_Info_To_JSON
then
722 Write_Str
("{ ""code"": ""?<>""");
723 Write_Str
(", ""operands"": [ ");
724 Print_Expr
(Node
.Op1
);
726 Print_Expr
(Node
.Op2
);
728 Print_Expr
(Node
.Op3
);
732 Print_Expr
(Node
.Op1
);
733 Write_Str
(" then ");
734 Print_Expr
(Node
.Op2
);
735 Write_Str
(" else ");
736 Print_Expr
(Node
.Op3
);
749 when Trunc_Div_Expr
=>
752 when Ceil_Div_Expr
=>
755 when Floor_Div_Expr
=>
758 when Trunc_Mod_Expr
=>
761 when Ceil_Mod_Expr
=>
764 when Floor_Mod_Expr
=>
767 when Exact_Div_Expr
=>
782 when Truth_And_Expr
=>
785 when Truth_Or_Expr
=>
788 when Truth_Xor_Expr
=>
791 when Truth_Not_Expr
=>
825 -- Start of processing for List_GCC_Expression
833 end List_GCC_Expression
;
835 -------------------------
836 -- List_Linker_Section --
837 -------------------------
839 procedure List_Linker_Section
(Ent
: Entity_Id
) is
844 if Present
(Linker_Section_Pragma
(Ent
)) then
845 Args
:= Pragma_Argument_Associations
(Linker_Section_Pragma
(Ent
));
846 Sect
:= Expr_Value_S
(Get_Pragma_Arg
(Last
(Args
)));
848 if List_Representation_Info_To_JSON
then
850 Write_Str
(" ""Linker_Section"": """);
852 Write_Str
("pragma Linker_Section (");
857 pragma Assert
(Nkind
(Sect
) = N_String_Literal
);
858 String_To_Name_Buffer
(Strval
(Sect
));
859 Write_Str
(Name_Buffer
(1 .. Name_Len
));
861 if not List_Representation_Info_To_JSON
then
865 end List_Linker_Section
;
871 procedure List_Location
(Ent
: Entity_Id
) is
873 pragma Assert
(List_Representation_Info_To_JSON
);
874 Write_Str
(" ""location"": """);
875 Write_Location
(Sloc
(Ent
));
883 procedure List_Name
(Ent
: Entity_Id
) is
887 -- In JSON mode, we recurse up to Standard. This is also valid in
888 -- default mode where we recurse up to the first compilation unit and
889 -- should not get to Standard.
891 if Scope
(Ent
) = Standard_Standard
then
893 elsif not Is_Compilation_Unit
(Scope
(Ent
))
894 or else List_Representation_Info_To_JSON
896 List_Name
(Scope
(Ent
));
900 Get_Unqualified_Decoded_Name_String
(Chars
(Ent
));
901 Set_Casing
(Unit_Casing
);
903 -- The name of operators needs to be properly escaped for JSON
905 for J
in 1 .. Name_Len
loop
906 C
:= Name_Buffer
(J
);
907 if C
= '"' and then List_Representation_Info_To_JSON
then
914 ---------------------
915 -- List_Object_Info --
916 ---------------------
918 procedure List_Object_Info
(Ent
: Entity_Id
) is
920 -- If size and alignment have not been computed (e.g. if we are in a
921 -- generic unit, or if the back end is not being run), don't try to
924 pragma Assert
(Known_Esize
(Ent
) = Known_Alignment
(Ent
));
925 if not Known_Alignment
(Ent
) then
931 if List_Representation_Info_To_JSON
then
934 Write_Str
(" ""name"": """);
939 Write_Str
(" ""Size"": ");
940 Write_Val
(Esize
(Ent
));
943 Write_Str
(" ""Alignment"": ");
944 Write_Val
(Alignment
(Ent
));
946 List_Linker_Section
(Ent
);
953 Write_Str
("'Size use ");
954 Write_Val
(Esize
(Ent
));
959 Write_Str
("'Alignment use ");
960 Write_Val
(Alignment
(Ent
));
963 List_Linker_Section
(Ent
);
966 -- The type is relevant for an object
968 if List_Representation_Info
= 4 and then Is_Itype
(Etype
(Ent
)) then
969 Relevant_Entities
.Set
(Etype
(Ent
), True);
971 end List_Object_Info
;
973 ----------------------
974 -- List_Record_Info --
975 ----------------------
977 procedure List_Record_Info
(Ent
: Entity_Id
; Bytes_Big_Endian
: Boolean) is
978 procedure Compute_Max_Length
980 Starting_Position
: Uint
:= Uint_0
;
981 Starting_First_Bit
: Uint
:= Uint_0
;
982 Prefix_Length
: Natural := 0);
983 -- Internal recursive procedure to compute the max length
985 procedure List_Component_Layout
987 Starting_Position
: Uint
:= Uint_0
;
988 Starting_First_Bit
: Uint
:= Uint_0
;
989 Prefix
: String := "";
990 Indent
: Natural := 0);
991 -- Procedure to display the layout of a single component
993 procedure List_Record_Layout
995 Starting_Position
: Uint
:= Uint_0
;
996 Starting_First_Bit
: Uint
:= Uint_0
;
997 Prefix
: String := "");
998 -- Internal recursive procedure to display the layout
1000 procedure List_Structural_Record_Layout
1002 Ext_Ent
: Entity_Id
;
1003 Ext_Level
: Integer := 0;
1004 Variant
: Node_Id
:= Empty
;
1005 Indent
: Natural := 0);
1006 -- Internal recursive procedure to display the structural layout.
1007 -- If Ext_Ent is not equal to Ent, it is an extension of Ent and
1008 -- Ext_Level is the number of successive extensions between them,
1009 -- with the convention that this number is positive when we are
1010 -- called from the fixed part of Ext_Ent and negative when we are
1011 -- called from the variant part of Ext_Ent, if any; this is needed
1012 -- because the fixed and variant parts of a parent of an extension
1013 -- cannot be listed contiguously from this extension's viewpoint.
1014 -- If Variant is present, it's for a variant in the variant part
1015 -- instead of the common part of Ent. Indent is the indentation.
1017 Incomplete_Layout
: exception;
1018 -- Exception raised if the layout is incomplete in -gnatc mode
1020 Not_In_Extended_Main
: exception;
1021 -- Exception raised when an ancestor is not declared in the main unit
1023 Max_Name_Length
: Natural := 0;
1024 Max_Spos_Length
: Natural := 0;
1026 ------------------------
1027 -- Compute_Max_Length --
1028 ------------------------
1030 procedure Compute_Max_Length
1032 Starting_Position
: Uint
:= Uint_0
;
1033 Starting_First_Bit
: Uint
:= Uint_0
;
1034 Prefix_Length
: Natural := 0)
1039 Comp
:= First_Component_Or_Discriminant
(Ent
);
1040 while Present
(Comp
) loop
1042 -- Skip a completely hidden discriminant or a discriminant in an
1043 -- unchecked union (since it is not there).
1045 if Ekind
(Comp
) = E_Discriminant
1046 and then (Is_Completely_Hidden
(Comp
)
1047 or else Is_Unchecked_Union
(Ent
))
1052 -- Skip _Parent component in extension (to avoid overlap)
1054 if Chars
(Comp
) = Name_uParent
then
1061 Ctyp
: constant Entity_Id
:= Underlying_Type
(Etype
(Comp
));
1062 Bofs
: constant Uint
:= Component_Bit_Offset
(Comp
);
1068 Name_Length
: Natural;
1071 Get_Decoded_Name_String
(Chars
(Comp
));
1072 Name_Length
:= Prefix_Length
+ Name_Len
;
1074 if Compile_Time_Known_Rep
(Bofs
) then
1076 Fbit
:= Bofs
mod SSU
;
1078 -- Complete annotation in case not done
1080 if not Known_Normalized_First_Bit
(Comp
) then
1081 Set_Normalized_Position
(Comp
, Npos
);
1082 Set_Normalized_First_Bit
(Comp
, Fbit
);
1085 Spos
:= Starting_Position
+ Npos
;
1086 Sbit
:= Starting_First_Bit
+ Fbit
;
1093 -- If extended information is requested, recurse fully into
1094 -- record components, i.e. skip the outer level.
1096 if List_Representation_Info_Extended
1097 and then Is_Record_Type
(Ctyp
)
1099 Compute_Max_Length
(Ctyp
, Spos
, Sbit
, Name_Length
+ 1);
1103 UI_Image
(Spos
, Format
=> Decimal
);
1105 -- If the record is not packed, then we know that all fields
1106 -- whose position is not specified have starting normalized
1107 -- bit position of zero.
1109 if not Known_Normalized_First_Bit
(Comp
)
1110 and then not Is_Packed
(Ent
)
1112 Set_Normalized_First_Bit
(Comp
, Uint_0
);
1115 UI_Image_Length
:= 2; -- For "??" marker
1118 Max_Name_Length
:= Natural'Max (Max_Name_Length
, Name_Length
);
1120 Natural'Max (Max_Spos_Length
, UI_Image_Length
);
1124 Next_Component_Or_Discriminant
(Comp
);
1126 end Compute_Max_Length
;
1128 ---------------------------
1129 -- List_Component_Layout --
1130 ---------------------------
1132 procedure List_Component_Layout
1134 Starting_Position
: Uint
:= Uint_0
;
1135 Starting_First_Bit
: Uint
:= Uint_0
;
1136 Prefix
: String := "";
1137 Indent
: Natural := 0)
1139 Esiz
: constant Uint
:= Esize
(Ent
);
1140 Npos
: constant Uint
:= Normalized_Position
(Ent
);
1141 Fbit
: constant Uint
:= Normalized_First_Bit
(Ent
);
1143 Sbit
: Uint
:= No_Uint
;
1147 if List_Representation_Info_To_JSON
then
1151 Write_Str
(" ""name"": """);
1153 Write_Str
(Name_Buffer
(1 .. Name_Len
));
1155 if Ekind
(Ent
) = E_Discriminant
then
1157 Write_Str
(" ""discriminant"": ");
1158 UI_Write
(Discriminant_Number
(Ent
), Decimal
);
1162 Write_Str
(" ""Position"": ");
1166 Write_Str
(Name_Buffer
(1 .. Name_Len
));
1167 Spaces
(Max_Name_Length
- Prefix
'Length - Name_Len
);
1171 if Known_Static_Normalized_Position
(Ent
) then
1172 Spos
:= Starting_Position
+ Npos
;
1173 Sbit
:= Starting_First_Bit
+ Fbit
;
1179 UI_Image
(Spos
, Format
=> Decimal
);
1180 Spaces
(Max_Spos_Length
- UI_Image_Length
);
1181 Write_Str
(UI_Image_Buffer
(1 .. UI_Image_Length
));
1183 elsif Known_Normalized_Position
(Ent
)
1184 and then List_Representation_Info
>= 3
1186 Spaces
(Max_Spos_Length
- 2);
1188 if Starting_Position
/= Uint_0
then
1189 UI_Write
(Starting_Position
, Decimal
);
1199 if List_Representation_Info_To_JSON
then
1202 Write_Str
(" ""First_Bit"": ");
1204 Write_Str
(" range ");
1207 if Known_Static_Normalized_First_Bit
(Ent
) then
1208 Sbit
:= Starting_First_Bit
+ Fbit
;
1214 UI_Write
(Sbit
, Decimal
);
1219 if List_Representation_Info_To_JSON
then
1222 Write_Str
(" ""Size"": ");
1227 if Known_Static_Esize
(Ent
)
1228 and then Known_Static_Normalized_First_Bit
(Ent
)
1230 Lbit
:= Sbit
+ Esiz
- 1;
1232 if List_Representation_Info_To_JSON
then
1233 UI_Write
(Esiz
, Decimal
);
1235 if Lbit
>= 0 and then Lbit
< 10 then
1239 UI_Write
(Lbit
, Decimal
);
1242 elsif List_Representation_Info
< 3 or else not Known_Esize
(Ent
) then
1245 -- List_Representation >= 3 and Known_Esize (Ent)
1248 Write_Val
(Esiz
, Paren
=> not List_Representation_Info_To_JSON
);
1250 -- Add appropriate first bit offset
1252 if not List_Representation_Info_To_JSON
then
1261 Write_Int
(UI_To_Int
(Sbit
) - 1);
1266 if List_Representation_Info_To_JSON
then
1274 -- The type is relevant for a component
1276 if List_Representation_Info
= 4 and then Is_Itype
(Etype
(Ent
)) then
1277 Relevant_Entities
.Set
(Etype
(Ent
), True);
1279 end List_Component_Layout
;
1281 ------------------------
1282 -- List_Record_Layout --
1283 ------------------------
1285 procedure List_Record_Layout
1287 Starting_Position
: Uint
:= Uint_0
;
1288 Starting_First_Bit
: Uint
:= Uint_0
;
1289 Prefix
: String := "")
1292 First
: Boolean := True;
1295 Comp
:= First_Component_Or_Discriminant
(Ent
);
1296 while Present
(Comp
) loop
1298 -- Skip a completely hidden discriminant or a discriminant in an
1299 -- unchecked union (since it is not there).
1301 if Ekind
(Comp
) = E_Discriminant
1302 and then (Is_Completely_Hidden
(Comp
)
1303 or else Is_Unchecked_Union
(Ent
))
1308 -- Skip _Parent component in extension (to avoid overlap)
1310 if Chars
(Comp
) = Name_uParent
then
1317 Ctyp
: constant Entity_Id
:= Underlying_Type
(Etype
(Comp
));
1318 Npos
: constant Uint
:= Normalized_Position
(Comp
);
1319 Fbit
: constant Uint
:= Normalized_First_Bit
(Comp
);
1324 Get_Decoded_Name_String
(Chars
(Comp
));
1325 Set_Casing
(Unit_Casing
);
1327 -- If extended information is requested, recurse fully into
1328 -- record components, i.e. skip the outer level.
1330 if List_Representation_Info_Extended
1331 and then Is_Record_Type
(Ctyp
)
1332 and then Known_Static_Normalized_Position
(Comp
)
1333 and then Known_Static_Normalized_First_Bit
(Comp
)
1335 Spos
:= Starting_Position
+ Npos
;
1336 Sbit
:= Starting_First_Bit
+ Fbit
;
1343 List_Record_Layout
(Ctyp
,
1344 Spos
, Sbit
, Prefix
& Name_Buffer
(1 .. Name_Len
) & ".");
1349 if List_Representation_Info_To_JSON
then
1358 -- The Parent_Subtype in an extension is not back-annotated
1360 List_Component_Layout
(
1361 (if Known_Normalized_Position
(Comp
)
1363 else Original_Record_Component
(Comp
)),
1364 Starting_Position
, Starting_First_Bit
, Prefix
);
1368 Next_Component_Or_Discriminant
(Comp
);
1370 end List_Record_Layout
;
1372 -----------------------------------
1373 -- List_Structural_Record_Layout --
1374 -----------------------------------
1376 procedure List_Structural_Record_Layout
1378 Ext_Ent
: Entity_Id
;
1379 Ext_Level
: Integer := 0;
1380 Variant
: Node_Id
:= Empty
;
1381 Indent
: Natural := 0)
1383 function Derived_Discriminant
(Disc
: Entity_Id
) return Entity_Id
;
1384 -- This function assumes that Ext_Ent is an extension of Ent.
1385 -- Disc is a discriminant of Ent that does not itself constrain a
1386 -- discriminant of the parent type of Ent. Return the discriminant
1387 -- of Ext_Ent that ultimately constrains Disc, if any.
1389 ----------------------------
1390 -- Derived_Discriminant --
1391 ----------------------------
1393 function Derived_Discriminant
(Disc
: Entity_Id
) return Entity_Id
is
1394 Corr_Disc
: Entity_Id
;
1395 Derived_Disc
: Entity_Id
;
1398 -- Deal with an extension of a type with unknown discriminants
1400 if Has_Unknown_Discriminants
(Ext_Ent
)
1401 and then Present
(Underlying_Record_View
(Ext_Ent
))
1404 First_Discriminant
(Underlying_Record_View
(Ext_Ent
));
1406 Derived_Disc
:= First_Discriminant
(Ext_Ent
);
1409 -- Loop over the discriminants of the extension
1411 while Present
(Derived_Disc
) loop
1413 -- Check if this discriminant constrains another discriminant.
1414 -- If so, find the ultimately constrained discriminant and
1415 -- compare with the original components in the base type.
1417 if Present
(Corresponding_Discriminant
(Derived_Disc
)) then
1418 Corr_Disc
:= Corresponding_Discriminant
(Derived_Disc
);
1420 while Present
(Corresponding_Discriminant
(Corr_Disc
)) loop
1421 Corr_Disc
:= Corresponding_Discriminant
(Corr_Disc
);
1424 if Original_Record_Component
(Corr_Disc
) =
1425 Original_Record_Component
(Disc
)
1427 return Derived_Disc
;
1431 Next_Discriminant
(Derived_Disc
);
1434 -- Disc is not constrained by a discriminant of Ext_Ent
1437 end Derived_Discriminant
;
1439 -- Local declarations
1442 Comp_List
: Node_Id
;
1443 First
: Boolean := True;
1444 Parent_Ent
: Entity_Id
:= Empty
;
1447 -- Start of processing for List_Structural_Record_Layout
1450 -- If we are dealing with a variant, just process the components
1452 if Present
(Variant
) then
1453 Comp_List
:= Component_List
(Variant
);
1455 -- Otherwise, we are dealing with the full record and need to get
1456 -- to its definition in order to retrieve its structural layout.
1460 Definition
: Node_Id
:=
1461 Type_Definition
(Declaration_Node
(Ent
));
1463 Is_Extension
: constant Boolean :=
1464 Is_Tagged_Type
(Ent
)
1465 and then Nkind
(Definition
) =
1466 N_Derived_Type_Definition
;
1469 Listed_Disc
: Entity_Id
;
1470 Parent_Type
: Entity_Id
;
1473 -- If this is an extension, first list the layout of the parent
1474 -- and then proceed to the extension part, if any.
1476 if Is_Extension
then
1477 Parent_Type
:= Parent_Subtype
(Ent
);
1478 if No
(Parent_Type
) then
1479 raise Incomplete_Layout
;
1482 if Is_Private_Type
(Parent_Type
) then
1483 Parent_Type
:= Full_View
(Parent_Type
);
1484 pragma Assert
(Present
(Parent_Type
));
1487 -- Do not list variants if one of them has been selected
1489 if Has_Static_Discriminants
(Parent_Type
) then
1490 List_Record_Layout
(Parent_Type
);
1493 Parent_Type
:= Base_Type
(Parent_Type
);
1494 if not In_Extended_Main_Source_Unit
(Parent_Type
) then
1495 raise Not_In_Extended_Main
;
1498 Parent_Ent
:= Parent_Type
;
1499 if Ext_Level
>= 0 then
1500 List_Structural_Record_Layout
1501 (Parent_Ent
, Ext_Ent
, Ext_Level
+ 1);
1507 if Present
(Record_Extension_Part
(Definition
)) then
1508 Definition
:= Record_Extension_Part
(Definition
);
1512 -- If the record has discriminants and is not an unchecked
1513 -- union, then display them now. Note that, even if this is
1514 -- a structural layout, we list the visible discriminants.
1516 if Has_Discriminants
(Ent
)
1517 and then not Is_Unchecked_Union
(Ent
)
1518 and then Ext_Level
>= 0
1520 Disc
:= First_Discriminant
(Ent
);
1521 while Present
(Disc
) loop
1523 -- If this is a record extension and the discriminant is
1524 -- the renaming of another discriminant, skip it.
1527 and then Present
(Corresponding_Discriminant
(Disc
))
1532 -- If this is the parent type of an extension, retrieve
1533 -- the derived discriminant from the extension, if any.
1535 if Ent
/= Ext_Ent
then
1536 Listed_Disc
:= Derived_Discriminant
(Disc
);
1538 if No
(Listed_Disc
) then
1541 elsif not Known_Normalized_Position
(Listed_Disc
) then
1543 Original_Record_Component
(Listed_Disc
);
1547 Listed_Disc
:= Disc
;
1550 Get_Decoded_Name_String
(Chars
(Listed_Disc
));
1551 Set_Casing
(Unit_Casing
);
1560 List_Component_Layout
(Listed_Disc
, Indent
=> Indent
);
1563 Next_Discriminant
(Disc
);
1567 Comp_List
:= Component_List
(Definition
);
1571 -- Bail out for the null record
1573 if No
(Comp_List
) then
1577 -- Now deal with the regular components, if any
1579 if Present
(Component_Items
(Comp_List
))
1580 and then (Present
(Variant
) or else Ext_Level
>= 0)
1582 Comp
:= First_Non_Pragma
(Component_Items
(Comp_List
));
1583 while Present
(Comp
) loop
1585 -- Skip _Parent component in extension (to avoid overlap)
1587 if Chars
(Defining_Identifier
(Comp
)) = Name_uParent
then
1591 Get_Decoded_Name_String
(Chars
(Defining_Identifier
(Comp
)));
1592 Set_Casing
(Unit_Casing
);
1601 List_Component_Layout
1602 (Defining_Identifier
(Comp
), Indent
=> Indent
);
1605 Next_Non_Pragma
(Comp
);
1609 -- Stop there if we are called from the fixed part of Ext_Ent,
1610 -- we'll do the variant part when called from its variant part.
1612 if Ext_Level
> 0 then
1616 -- List the layout of the variant part of the parent, if any
1618 if Present
(Parent_Ent
) then
1619 List_Structural_Record_Layout
1620 (Parent_Ent
, Ext_Ent
, Ext_Level
- 1);
1623 -- We are done if there is no variant part
1625 if No
(Variant_Part
(Comp_List
)) then
1634 for J
in Ext_Level
.. -1 loop
1635 Write_Str
("parent_");
1637 Write_Str
("variant"" : [");
1639 -- Otherwise we recurse on each variant
1641 Var
:= First_Non_Pragma
(Variants
(Variant_Part
(Comp_List
)));
1643 while Present
(Var
) loop
1654 Write_Str
(" ""present"": ");
1655 Write_Val
(Present_Expr
(Var
));
1658 Write_Str
(" ""record"": [");
1660 List_Structural_Record_Layout
1661 (Ent
, Ext_Ent
, Ext_Level
, Var
, Indent
+ 4);
1668 Next_Non_Pragma
(Var
);
1670 end List_Structural_Record_Layout
;
1672 -- Start of processing for List_Record_Info
1677 if List_Representation_Info_To_JSON
then
1681 List_Common_Type_Info
(Ent
);
1683 -- First find out max line length and max starting position
1684 -- length, for the purpose of lining things up nicely.
1686 Compute_Max_Length
(Ent
);
1688 -- Then do actual output based on those values
1690 if List_Representation_Info_To_JSON
then
1692 Write_Str
(" ""record"": [");
1694 -- ??? We can output structural layout only for base types fully
1695 -- declared in the extended main source unit for the time being,
1696 -- because otherwise declarations might not be processed at all.
1698 if Is_Base_Type
(Ent
) then
1700 List_Structural_Record_Layout
(Ent
, Ent
);
1703 when Incomplete_Layout
1704 | Not_In_Extended_Main
1706 List_Record_Layout
(Ent
);
1709 raise Program_Error
;
1712 List_Record_Layout
(Ent
);
1720 Write_Line
(" use record");
1722 List_Record_Layout
(Ent
);
1724 Write_Line
("end record;");
1727 List_Scalar_Storage_Order
(Ent
, Bytes_Big_Endian
);
1729 List_Linker_Section
(Ent
);
1731 if List_Representation_Info_To_JSON
then
1736 -- The type is relevant for a record subtype
1738 if List_Representation_Info
= 4
1739 and then not Is_Base_Type
(Ent
)
1740 and then Is_Itype
(Etype
(Ent
))
1742 Relevant_Entities
.Set
(Etype
(Ent
), True);
1744 end List_Record_Info
;
1750 procedure List_Rep_Info
(Bytes_Big_Endian
: Boolean) is
1754 if List_Representation_Info
/= 0
1755 or else List_Representation_Info_Mechanisms
1757 -- For the normal case, we output a single JSON stream
1759 if not List_Representation_Info_To_File
1760 and then List_Representation_Info_To_JSON
1763 Need_Separator
:= False;
1766 for U
in Main_Unit
.. Last_Unit
loop
1767 if In_Extended_Main_Source_Unit
(Cunit_Entity
(U
)) then
1768 Unit_Casing
:= Identifier_Casing
(Source_Index
(U
));
1770 if List_Representation_Info
= 4 then
1771 Relevant_Entities
.Reset
;
1774 -- Normal case, list to standard output
1776 if not List_Representation_Info_To_File
then
1777 if not List_Representation_Info_To_JSON
then
1779 Write_Str
("Representation information for unit ");
1780 Write_Unit_Name
(Unit_Name
(U
));
1784 for J
in 1 .. Col
- 1 loop
1789 Need_Separator
:= True;
1792 List_Entities
(Cunit_Entity
(U
), Bytes_Big_Endian
);
1794 -- List representation information to file
1798 (Get_Name_String
(File_Name
(Source_Index
(U
))));
1799 Set_Special_Output
(Write_Info_Line
'Access);
1800 if List_Representation_Info_To_JSON
then
1803 Need_Separator
:= False;
1804 List_Entities
(Cunit_Entity
(U
), Bytes_Big_Endian
);
1805 if List_Representation_Info_To_JSON
then
1808 Cancel_Special_Output
;
1814 if not List_Representation_Info_To_File
1815 and then List_Representation_Info_To_JSON
1822 -------------------------------
1823 -- List_Scalar_Storage_Order --
1824 -------------------------------
1826 procedure List_Scalar_Storage_Order
1828 Bytes_Big_Endian
: Boolean)
1830 procedure List_Attr
(Attr_Name
: String; Is_Reversed
: Boolean);
1831 -- Show attribute definition clause for Attr_Name (an endianness
1832 -- attribute), depending on whether or not the endianness is reversed
1833 -- compared to native endianness.
1839 procedure List_Attr
(Attr_Name
: String; Is_Reversed
: Boolean) is
1841 if List_Representation_Info_To_JSON
then
1844 Write_Str
(Attr_Name
);
1845 Write_Str
(""": ""System.");
1850 Write_Str
(Attr_Name
);
1851 Write_Str
(" use System.");
1854 if Bytes_Big_Endian
xor Is_Reversed
then
1860 Write_Str
("_Order_First");
1861 if List_Representation_Info_To_JSON
then
1868 List_SSO
: constant Boolean :=
1869 Has_Rep_Item
(Ent
, Name_Scalar_Storage_Order
)
1870 or else SSO_Set_Low_By_Default
(Ent
)
1871 or else SSO_Set_High_By_Default
(Ent
);
1872 -- Scalar_Storage_Order is displayed if specified explicitly or set by
1873 -- Default_Scalar_Storage_Order.
1875 -- Start of processing for List_Scalar_Storage_Order
1878 -- For record types, list Bit_Order if not default, or if SSO is shown
1880 -- Also, when -gnatR4 is in effect always list bit order and scalar
1881 -- storage order explicitly, so that you don't need to know the native
1882 -- endianness of the target for which the output was produced in order
1885 if Is_Record_Type
(Ent
)
1887 or else Reverse_Bit_Order
(Ent
)
1888 or else List_Representation_Info
= 4)
1890 List_Attr
("Bit_Order", Reverse_Bit_Order
(Ent
));
1893 -- List SSO if required. If not, then storage is supposed to be in
1896 if List_SSO
or else List_Representation_Info
= 4 then
1897 List_Attr
("Scalar_Storage_Order", Reverse_Storage_Order
(Ent
));
1899 pragma Assert
(not Reverse_Storage_Order
(Ent
));
1902 end List_Scalar_Storage_Order
;
1904 --------------------------
1905 -- List_Subprogram_Info --
1906 --------------------------
1908 procedure List_Subprogram_Info
(Ent
: Entity_Id
) is
1909 First
: Boolean := True;
1916 if List_Representation_Info_To_JSON
then
1918 Write_Str
(" ""name"": """);
1921 List_Location
(Ent
);
1923 Write_Str
(" ""Convention"": """);
1927 Write_Str
("function ");
1930 Write_Str
("operator ");
1933 Write_Str
("procedure ");
1935 when E_Subprogram_Type
=>
1936 Write_Str
("type ");
1941 Write_Str
("entry ");
1944 raise Program_Error
;
1948 Write_Str
(" declared at ");
1949 Write_Location
(Sloc
(Ent
));
1952 Write_Str
("convention : ");
1955 case Convention
(Ent
) is
1956 when Convention_Ada
=>
1959 when Convention_Ada_Pass_By_Copy
=>
1960 Write_Str
("Ada_Pass_By_Copy");
1962 when Convention_Ada_Pass_By_Reference
=>
1963 Write_Str
("Ada_Pass_By_Reference");
1965 when Convention_Intrinsic
=>
1966 Write_Str
("Intrinsic");
1968 when Convention_Entry
=>
1969 Write_Str
("Entry");
1971 when Convention_Protected
=>
1972 Write_Str
("Protected");
1974 when Convention_Assembler
=>
1975 Write_Str
("Assembler");
1977 when Convention_C
=>
1980 when Convention_C_Variadic
=>
1983 Convention_Id
'Pos (Convention
(Ent
)) -
1984 Convention_Id
'Pos (Convention_C_Variadic_0
);
1986 Write_Str
("C_Variadic_");
1991 pragma Assert
(N
< 10);
1992 Write_Char
(Character'Val (Character'Pos ('0') + N
));
1995 when Convention_COBOL
=>
1996 Write_Str
("COBOL");
1998 when Convention_CPP
=>
2001 when Convention_Fortran
=>
2002 Write_Str
("Fortran");
2004 when Convention_Stdcall
=>
2005 Write_Str
("Stdcall");
2007 when Convention_Stubbed
=>
2008 Write_Str
("Stubbed");
2011 if List_Representation_Info_To_JSON
then
2013 Write_Str
(" ""formal"": [");
2018 -- Find max length of formal name
2021 Form
:= First_Formal
(Ent
);
2022 while Present
(Form
) loop
2023 Get_Unqualified_Decoded_Name_String
(Chars
(Form
));
2025 if Name_Len
> Plen
then
2032 -- Output formals and mechanisms
2034 Form
:= First_Formal
(Ent
);
2035 while Present
(Form
) loop
2036 Get_Unqualified_Decoded_Name_String
(Chars
(Form
));
2037 Set_Casing
(Unit_Casing
);
2039 if List_Representation_Info_To_JSON
then
2048 Write_Str
(" ""name"": """);
2049 Write_Str
(Name_Buffer
(1 .. Name_Len
));
2052 Write_Str
(" ""mechanism"": """);
2053 Write_Mechanism
(Mechanism
(Form
));
2057 while Name_Len
<= Plen
loop
2058 Name_Len
:= Name_Len
+ 1;
2059 Name_Buffer
(Name_Len
) := ' ';
2063 Write_Str
(Name_Buffer
(1 .. Plen
+ 1));
2064 Write_Str
(": passed by ");
2066 Write_Mechanism
(Mechanism
(Form
));
2073 if List_Representation_Info_To_JSON
then
2078 if Ekind
(Ent
) = E_Function
then
2079 if List_Representation_Info_To_JSON
then
2081 Write_Str
(" ""mechanism"": """);
2082 Write_Mechanism
(Mechanism
(Ent
));
2085 Write_Str
("returns by ");
2086 Write_Mechanism
(Mechanism
(Ent
));
2091 if not Is_Entry
(Ent
) then
2092 List_Linker_Section
(Ent
);
2095 if List_Representation_Info_To_JSON
then
2099 end List_Subprogram_Info
;
2101 --------------------
2102 -- List_Type_Info --
2103 --------------------
2105 procedure List_Type_Info
(Ent
: Entity_Id
) is
2109 if List_Representation_Info_To_JSON
then
2113 List_Common_Type_Info
(Ent
);
2115 -- Special stuff for fixed-point
2117 if Is_Fixed_Point_Type
(Ent
) then
2119 -- Write small (always a static constant)
2121 if List_Representation_Info_To_JSON
then
2123 Write_Str
(" ""Small"": ");
2124 UR_Write_To_JSON
(Small_Value
(Ent
));
2128 Write_Str
("'Small use ");
2129 UR_Write
(Small_Value
(Ent
));
2133 -- Write range if static
2136 R
: constant Node_Id
:= Scalar_Range
(Ent
);
2139 if Nkind
(Low_Bound
(R
)) = N_Real_Literal
2141 Nkind
(High_Bound
(R
)) = N_Real_Literal
2143 if List_Representation_Info_To_JSON
then
2145 Write_Str
(" ""Range"": [ ");
2146 UR_Write_To_JSON
(Realval
(Low_Bound
(R
)));
2148 UR_Write_To_JSON
(Realval
(High_Bound
(R
)));
2153 Write_Str
("'Range use ");
2154 UR_Write
(Realval
(Low_Bound
(R
)));
2156 UR_Write
(Realval
(High_Bound
(R
)));
2163 List_Linker_Section
(Ent
);
2165 if List_Representation_Info_To_JSON
then
2171 ----------------------------
2172 -- Compile_Time_Known_Rep --
2173 ----------------------------
2175 function Compile_Time_Known_Rep
(Val
: Node_Ref_Or_Val
) return Boolean is
2177 return Present
(Val
) and then Val
>= 0;
2178 end Compile_Time_Known_Rep
;
2184 function Rep_Value
(Val
: Node_Ref_Or_Val
; D
: Discrim_List
) return Uint
is
2186 function B
(Val
: Boolean) return Ubool
;
2187 -- Returns Uint_0 for False, Uint_1 for True
2189 function T
(Val
: Node_Ref_Or_Val
) return Boolean;
2190 -- Returns True for 0, False for any non-zero (i.e. True)
2192 function V
(Val
: Node_Ref_Or_Val
) return Uint
;
2193 -- Internal recursive routine to evaluate tree
2195 function W
(Val
: Uint
) return Word
;
2196 -- Convert Val to Word, assuming Val is always in the Int range. This
2197 -- is a helper function for the evaluation of bitwise expressions like
2198 -- Bit_And_Expr, for which there is no direct support in uintp. Uint
2199 -- values out of the Int range are expected to be seen in such
2200 -- expressions only with overflowing byte sizes around, introducing
2201 -- inherent unreliabilities in computations anyway.
2207 function B
(Val
: Boolean) return Ubool
is
2220 function T
(Val
: Node_Ref_Or_Val
) return Boolean is
2233 function V
(Val
: Node_Ref_Or_Val
) return Uint
is
2242 Node
: Exp_Node
renames Rep_Table
.Table
(-UI_To_Int
(Val
));
2247 if T
(Node
.Op1
) then
2248 return V
(Node
.Op2
);
2250 return V
(Node
.Op3
);
2254 return V
(Node
.Op1
) + V
(Node
.Op2
);
2257 return V
(Node
.Op1
) - V
(Node
.Op2
);
2260 return V
(Node
.Op1
) * V
(Node
.Op2
);
2262 when Trunc_Div_Expr
=>
2263 return V
(Node
.Op1
) / V
(Node
.Op2
);
2265 when Ceil_Div_Expr
=>
2268 (V
(Node
.Op1
) / UR_From_Uint
(V
(Node
.Op2
)));
2270 when Floor_Div_Expr
=>
2273 (V
(Node
.Op1
) / UR_From_Uint
(V
(Node
.Op2
)));
2275 when Trunc_Mod_Expr
=>
2276 return V
(Node
.Op1
) rem V
(Node
.Op2
);
2278 when Floor_Mod_Expr
=>
2279 return V
(Node
.Op1
) mod V
(Node
.Op2
);
2281 when Ceil_Mod_Expr
=>
2284 Q
:= UR_Ceiling
(L
/ UR_From_Uint
(R
));
2287 when Exact_Div_Expr
=>
2288 return V
(Node
.Op1
) / V
(Node
.Op2
);
2291 return -V
(Node
.Op1
);
2294 return UI_Min
(V
(Node
.Op1
), V
(Node
.Op2
));
2297 return UI_Max
(V
(Node
.Op1
), V
(Node
.Op2
));
2300 return UI_Abs
(V
(Node
.Op1
));
2302 when Truth_And_Expr
=>
2303 return B
(T
(Node
.Op1
) and then T
(Node
.Op2
));
2305 when Truth_Or_Expr
=>
2306 return B
(T
(Node
.Op1
) or else T
(Node
.Op2
));
2308 when Truth_Xor_Expr
=>
2309 return B
(T
(Node
.Op1
) xor T
(Node
.Op2
));
2311 when Truth_Not_Expr
=>
2312 return B
(not T
(Node
.Op1
));
2314 when Bit_And_Expr
=>
2317 return UI_From_Int
(Int
(W
(L
) and W
(R
)));
2320 return B
(V
(Node
.Op1
) < V
(Node
.Op2
));
2323 return B
(V
(Node
.Op1
) <= V
(Node
.Op2
));
2326 return B
(V
(Node
.Op1
) > V
(Node
.Op2
));
2329 return B
(V
(Node
.Op1
) >= V
(Node
.Op2
));
2332 return B
(V
(Node
.Op1
) = V
(Node
.Op2
));
2335 return B
(V
(Node
.Op1
) /= V
(Node
.Op2
));
2339 Sub
: constant Int
:= UI_To_Int
(Node
.Op1
);
2341 pragma Assert
(Sub
in D
'Range);
2356 -- We use an unchecked conversion to map Int values to their Word
2357 -- bitwise equivalent, which we could not achieve with a normal type
2358 -- conversion for negative Ints. We want bitwise equivalents because W
2359 -- is used as a helper for bit operators like Bit_And_Expr, and can be
2360 -- called for negative Ints in the context of aligning expressions like
2361 -- X+Align & -Align.
2363 function W
(Val
: Uint
) return Word
is
2364 function To_Word
is new Ada
.Unchecked_Conversion
(Int
, Word
);
2366 return To_Word
(UI_To_Int
(Val
));
2369 -- Start of processing for Rep_Value
2384 procedure Spaces
(N
: Natural) is
2386 for J
in 1 .. N
loop
2391 ---------------------
2392 -- Write_Info_Line --
2393 ---------------------
2395 procedure Write_Info_Line
(S
: String) is
2397 Write_Repinfo_Line
(S
(S
'First .. S
'Last - 1));
2398 end Write_Info_Line
;
2400 ---------------------
2401 -- Write_Mechanism --
2402 ---------------------
2404 procedure Write_Mechanism
(M
: Mechanism_Type
) is
2408 Write_Str
("default");
2414 Write_Str
("reference");
2417 raise Program_Error
;
2419 end Write_Mechanism
;
2421 ---------------------
2422 -- Write_Separator --
2423 ---------------------
2425 procedure Write_Separator
is
2427 if Need_Separator
then
2428 if List_Representation_Info_To_JSON
then
2434 Need_Separator
:= True;
2436 end Write_Separator
;
2438 -----------------------
2439 -- Write_Unknown_Val --
2440 -----------------------
2442 procedure Write_Unknown_Val
is
2444 if List_Representation_Info_To_JSON
then
2445 Write_Str
("""??""");
2449 end Write_Unknown_Val
;
2455 procedure Write_Val
(Val
: Node_Ref_Or_Val
; Paren
: Boolean := False) is
2457 if Compile_Time_Known_Rep
(Val
) then
2458 UI_Write
(Val
, Decimal
);
2459 elsif List_Representation_Info
< 3 or else No
(Val
) then
2466 List_GCC_Expression
(Val
);