annotate gcc/ada/libgnat/g-alvety.ads @ 111:04ced10e8804

gcc 7
author kono
date Fri, 27 Oct 2017 22:46:09 +0900
parents
children 84e7813d76e9
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
111
kono
parents:
diff changeset
1 ------------------------------------------------------------------------------
kono
parents:
diff changeset
2 -- --
kono
parents:
diff changeset
3 -- GNAT COMPILER COMPONENTS --
kono
parents:
diff changeset
4 -- --
kono
parents:
diff changeset
5 -- G N A T . A L T I V E C . V E C T O R _ T Y P E S --
kono
parents:
diff changeset
6 -- --
kono
parents:
diff changeset
7 -- S p e c --
kono
parents:
diff changeset
8 -- --
kono
parents:
diff changeset
9 -- Copyright (C) 2004-2017, Free Software Foundation, Inc. --
kono
parents:
diff changeset
10 -- --
kono
parents:
diff changeset
11 -- GNAT is free software; you can redistribute it and/or modify it under --
kono
parents:
diff changeset
12 -- terms of the GNU General Public License as published by the Free Soft- --
kono
parents:
diff changeset
13 -- ware Foundation; either version 3, or (at your option) any later ver- --
kono
parents:
diff changeset
14 -- sion. GNAT is distributed in the hope that it will be useful, but WITH- --
kono
parents:
diff changeset
15 -- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY --
kono
parents:
diff changeset
16 -- or FITNESS FOR A PARTICULAR PURPOSE. --
kono
parents:
diff changeset
17 -- --
kono
parents:
diff changeset
18 -- As a special exception under Section 7 of GPL version 3, you are granted --
kono
parents:
diff changeset
19 -- additional permissions described in the GCC Runtime Library Exception, --
kono
parents:
diff changeset
20 -- version 3.1, as published by the Free Software Foundation. --
kono
parents:
diff changeset
21 -- --
kono
parents:
diff changeset
22 -- You should have received a copy of the GNU General Public License and --
kono
parents:
diff changeset
23 -- a copy of the GCC Runtime Library Exception along with this program; --
kono
parents:
diff changeset
24 -- see the files COPYING3 and COPYING.RUNTIME respectively. If not, see --
kono
parents:
diff changeset
25 -- <http://www.gnu.org/licenses/>. --
kono
parents:
diff changeset
26 -- --
kono
parents:
diff changeset
27 -- GNAT was originally developed by the GNAT team at New York University. --
kono
parents:
diff changeset
28 -- Extensive contributions were provided by Ada Core Technologies Inc. --
kono
parents:
diff changeset
29 -- --
kono
parents:
diff changeset
30 ------------------------------------------------------------------------------
kono
parents:
diff changeset
31
kono
parents:
diff changeset
32 -- This unit exposes the various vector types part of the Ada binding to
kono
parents:
diff changeset
33 -- Altivec facilities.
kono
parents:
diff changeset
34
kono
parents:
diff changeset
35 with GNAT.Altivec.Low_Level_Vectors;
kono
parents:
diff changeset
36
kono
parents:
diff changeset
37 package GNAT.Altivec.Vector_Types is
kono
parents:
diff changeset
38
kono
parents:
diff changeset
39 ---------------------------------------------------
kono
parents:
diff changeset
40 -- Vector type declarations [PIM-2.1 Data Types] --
kono
parents:
diff changeset
41 ---------------------------------------------------
kono
parents:
diff changeset
42
kono
parents:
diff changeset
43 -- Except for assignments and pointer creation/dereference, operations
kono
parents:
diff changeset
44 -- on vectors are only performed via subprograms. The vector types are
kono
parents:
diff changeset
45 -- then private, and non-limited since assignments are allowed.
kono
parents:
diff changeset
46
kono
parents:
diff changeset
47 -- The Hard/Soft binding type-structure differentiation is achieved in
kono
parents:
diff changeset
48 -- Low_Level_Vectors. Each version only exposes private vector types, that
kono
parents:
diff changeset
49 -- we just sub-type here. This is fine from the design standpoint and
kono
parents:
diff changeset
50 -- reduces the amount of explicit conversion required in various places
kono
parents:
diff changeset
51 -- internally.
kono
parents:
diff changeset
52
kono
parents:
diff changeset
53 subtype vector_unsigned_char is Low_Level_Vectors.LL_VUC;
kono
parents:
diff changeset
54 subtype vector_signed_char is Low_Level_Vectors.LL_VSC;
kono
parents:
diff changeset
55 subtype vector_bool_char is Low_Level_Vectors.LL_VBC;
kono
parents:
diff changeset
56
kono
parents:
diff changeset
57 subtype vector_unsigned_short is Low_Level_Vectors.LL_VUS;
kono
parents:
diff changeset
58 subtype vector_signed_short is Low_Level_Vectors.LL_VSS;
kono
parents:
diff changeset
59 subtype vector_bool_short is Low_Level_Vectors.LL_VBS;
kono
parents:
diff changeset
60
kono
parents:
diff changeset
61 subtype vector_unsigned_int is Low_Level_Vectors.LL_VUI;
kono
parents:
diff changeset
62 subtype vector_signed_int is Low_Level_Vectors.LL_VSI;
kono
parents:
diff changeset
63 subtype vector_bool_int is Low_Level_Vectors.LL_VBI;
kono
parents:
diff changeset
64
kono
parents:
diff changeset
65 subtype vector_float is Low_Level_Vectors.LL_VF;
kono
parents:
diff changeset
66 subtype vector_pixel is Low_Level_Vectors.LL_VP;
kono
parents:
diff changeset
67
kono
parents:
diff changeset
68 -- [PIM-2.1] shows groups of declarations with exact same component types,
kono
parents:
diff changeset
69 -- e.g. vector unsigned short together with vector unsigned short int. It
kono
parents:
diff changeset
70 -- so appears tempting to define subtypes for those matches here.
kono
parents:
diff changeset
71 --
kono
parents:
diff changeset
72 -- [PIM-2.1] does not qualify items in those groups as "the same types",
kono
parents:
diff changeset
73 -- though, and [PIM-2.4.2 Assignments] reads: "if either the left hand
kono
parents:
diff changeset
74 -- side or the right hand side of an expression has a vector type, then
kono
parents:
diff changeset
75 -- both sides of the expression must be of the same vector type".
kono
parents:
diff changeset
76 --
kono
parents:
diff changeset
77 -- Not so clear what is exactly right, then. We go with subtypes for now
kono
parents:
diff changeset
78 -- and can adjust later if need be.
kono
parents:
diff changeset
79
kono
parents:
diff changeset
80 subtype vector_unsigned_short_int is vector_unsigned_short;
kono
parents:
diff changeset
81 subtype vector_signed_short_int is vector_signed_short;
kono
parents:
diff changeset
82
kono
parents:
diff changeset
83 subtype vector_char is vector_signed_char;
kono
parents:
diff changeset
84 subtype vector_short is vector_signed_short;
kono
parents:
diff changeset
85 subtype vector_int is vector_signed_int;
kono
parents:
diff changeset
86
kono
parents:
diff changeset
87 --------------------------------
kono
parents:
diff changeset
88 -- Corresponding access types --
kono
parents:
diff changeset
89 --------------------------------
kono
parents:
diff changeset
90
kono
parents:
diff changeset
91 type vector_unsigned_char_ptr is access all vector_unsigned_char;
kono
parents:
diff changeset
92 type vector_signed_char_ptr is access all vector_signed_char;
kono
parents:
diff changeset
93 type vector_bool_char_ptr is access all vector_bool_char;
kono
parents:
diff changeset
94
kono
parents:
diff changeset
95 type vector_unsigned_short_ptr is access all vector_unsigned_short;
kono
parents:
diff changeset
96 type vector_signed_short_ptr is access all vector_signed_short;
kono
parents:
diff changeset
97 type vector_bool_short_ptr is access all vector_bool_short;
kono
parents:
diff changeset
98
kono
parents:
diff changeset
99 type vector_unsigned_int_ptr is access all vector_unsigned_int;
kono
parents:
diff changeset
100 type vector_signed_int_ptr is access all vector_signed_int;
kono
parents:
diff changeset
101 type vector_bool_int_ptr is access all vector_bool_int;
kono
parents:
diff changeset
102
kono
parents:
diff changeset
103 type vector_float_ptr is access all vector_float;
kono
parents:
diff changeset
104 type vector_pixel_ptr is access all vector_pixel;
kono
parents:
diff changeset
105
kono
parents:
diff changeset
106 --------------------------------------------------------------------
kono
parents:
diff changeset
107 -- Additional access types, for the sake of some argument passing --
kono
parents:
diff changeset
108 --------------------------------------------------------------------
kono
parents:
diff changeset
109
kono
parents:
diff changeset
110 -- ... because some of the operations expect pointers to possibly
kono
parents:
diff changeset
111 -- constant objects.
kono
parents:
diff changeset
112
kono
parents:
diff changeset
113 type const_vector_bool_char_ptr is access constant vector_bool_char;
kono
parents:
diff changeset
114 type const_vector_signed_char_ptr is access constant vector_signed_char;
kono
parents:
diff changeset
115 type const_vector_unsigned_char_ptr is access constant vector_unsigned_char;
kono
parents:
diff changeset
116
kono
parents:
diff changeset
117 type const_vector_bool_short_ptr is access constant vector_bool_short;
kono
parents:
diff changeset
118 type const_vector_signed_short_ptr is access constant vector_signed_short;
kono
parents:
diff changeset
119 type const_vector_unsigned_short_ptr is access
kono
parents:
diff changeset
120 constant vector_unsigned_short;
kono
parents:
diff changeset
121
kono
parents:
diff changeset
122 type const_vector_bool_int_ptr is access constant vector_bool_int;
kono
parents:
diff changeset
123 type const_vector_signed_int_ptr is access constant vector_signed_int;
kono
parents:
diff changeset
124 type const_vector_unsigned_int_ptr is access constant vector_unsigned_int;
kono
parents:
diff changeset
125
kono
parents:
diff changeset
126 type const_vector_float_ptr is access constant vector_float;
kono
parents:
diff changeset
127 type const_vector_pixel_ptr is access constant vector_pixel;
kono
parents:
diff changeset
128
kono
parents:
diff changeset
129 ----------------------
kono
parents:
diff changeset
130 -- Useful shortcuts --
kono
parents:
diff changeset
131 ----------------------
kono
parents:
diff changeset
132
kono
parents:
diff changeset
133 subtype VUC is vector_unsigned_char;
kono
parents:
diff changeset
134 subtype VSC is vector_signed_char;
kono
parents:
diff changeset
135 subtype VBC is vector_bool_char;
kono
parents:
diff changeset
136
kono
parents:
diff changeset
137 subtype VUS is vector_unsigned_short;
kono
parents:
diff changeset
138 subtype VSS is vector_signed_short;
kono
parents:
diff changeset
139 subtype VBS is vector_bool_short;
kono
parents:
diff changeset
140
kono
parents:
diff changeset
141 subtype VUI is vector_unsigned_int;
kono
parents:
diff changeset
142 subtype VSI is vector_signed_int;
kono
parents:
diff changeset
143 subtype VBI is vector_bool_int;
kono
parents:
diff changeset
144
kono
parents:
diff changeset
145 subtype VP is vector_pixel;
kono
parents:
diff changeset
146 subtype VF is vector_float;
kono
parents:
diff changeset
147
kono
parents:
diff changeset
148 end GNAT.Altivec.Vector_Types;