softfloat.h revision 1.3 1 /* $NetBSD: softfloat.h,v 1.3 2002/05/12 13:12:46 bjh21 Exp $ */
2
3 /* This is a derivative work. */
4
5 /*
6 ===============================================================================
7
8 This C header file is part of the SoftFloat IEC/IEEE Floating-point
9 Arithmetic Package, Release 2a.
10
11 Written by John R. Hauser. This work was made possible in part by the
12 International Computer Science Institute, located at Suite 600, 1947 Center
13 Street, Berkeley, California 94704. Funding was partially provided by the
14 National Science Foundation under grant MIP-9311980. The original version
15 of this code was written as part of a project to build a fixed-point vector
16 processor in collaboration with the University of California at Berkeley,
17 overseen by Profs. Nelson Morgan and John Wawrzynek. More information
18 is available through the Web page `http://HTTP.CS.Berkeley.EDU/~jhauser/
19 arithmetic/SoftFloat.html'.
20
21 THIS SOFTWARE IS DISTRIBUTED AS IS, FOR FREE. Although reasonable effort
22 has been made to avoid it, THIS SOFTWARE MAY CONTAIN FAULTS THAT WILL AT
23 TIMES RESULT IN INCORRECT BEHAVIOR. USE OF THIS SOFTWARE IS RESTRICTED TO
24 PERSONS AND ORGANIZATIONS WHO CAN AND WILL TAKE FULL RESPONSIBILITY FOR ANY
25 AND ALL LOSSES, COSTS, OR OTHER PROBLEMS ARISING FROM ITS USE.
26
27 Derivative works are acceptable, even for commercial purposes, so long as
28 (1) they include prominent notice that the work is derivative, and (2) they
29 include prominent notice akin to these four paragraphs for those parts of
30 this code that are retained.
31
32 ===============================================================================
33 */
34
35 /*
36 -------------------------------------------------------------------------------
37 The macro `FLOATX80' must be defined to enable the extended double-precision
38 floating-point format `floatx80'. If this macro is not defined, the
39 `floatx80' type will not be defined, and none of the functions that either
40 input or output the `floatx80' type will be defined. The same applies to
41 the `FLOAT128' macro and the quadruple-precision format `float128'.
42 -------------------------------------------------------------------------------
43 */
44 /* #define FLOATX80 */
45 /* #define FLOAT128 */
46
47 #include <machine/ieeefp.h>
48
49 /*
50 -------------------------------------------------------------------------------
51 Software IEC/IEEE floating-point types.
52 -------------------------------------------------------------------------------
53 */
54 typedef unsigned int float32;
55 typedef unsigned long long float64;
56 #ifdef FLOATX80
57 typedef struct {
58 unsigned short high;
59 unsigned long long low;
60 } floatx80;
61 #endif
62 #ifdef FLOAT128
63 typedef struct {
64 unsigned long long high, low;
65 } float128;
66 #endif
67
68 /*
69 -------------------------------------------------------------------------------
70 Software IEC/IEEE floating-point underflow tininess-detection mode.
71 -------------------------------------------------------------------------------
72 */
73 extern int8 float_detect_tininess;
74 enum {
75 float_tininess_after_rounding = 0,
76 float_tininess_before_rounding = 1
77 };
78
79 /*
80 -------------------------------------------------------------------------------
81 Software IEC/IEEE floating-point rounding mode.
82 -------------------------------------------------------------------------------
83 */
84 extern fp_rnd float_rounding_mode;
85 enum {
86 float_round_nearest_even = FP_RN,
87 float_round_to_zero = FP_RZ,
88 float_round_down = FP_RM,
89 float_round_up = FP_RP
90 };
91
92 /*
93 -------------------------------------------------------------------------------
94 Software IEC/IEEE floating-point exception flags.
95 -------------------------------------------------------------------------------
96 */
97 extern fp_except float_exception_flags;
98 extern fp_except float_exception_mask;
99 enum {
100 float_flag_inexact = FP_X_IMP,
101 float_flag_underflow = FP_X_UFL,
102 float_flag_overflow = FP_X_OFL,
103 float_flag_divbyzero = FP_X_DZ,
104 float_flag_invalid = FP_X_INV
105 };
106
107 /*
108 -------------------------------------------------------------------------------
109 Routine to raise any or all of the software IEC/IEEE floating-point
110 exception flags.
111 -------------------------------------------------------------------------------
112 */
113 void float_raise( fp_except );
114
115 /*
116 -------------------------------------------------------------------------------
117 Software IEC/IEEE integer-to-floating-point conversion routines.
118 -------------------------------------------------------------------------------
119 */
120 float32 int32_to_float32( int );
121 float64 int32_to_float64( int );
122 #ifdef FLOATX80
123 floatx80 int32_to_floatx80( int );
124 #endif
125 #ifdef FLOAT128
126 float128 int32_to_float128( int );
127 #endif
128 float32 int64_to_float32( long long );
129 float64 int64_to_float64( long long );
130 #ifdef FLOATX80
131 floatx80 int64_to_floatx80( long long );
132 #endif
133 #ifdef FLOAT128
134 float128 int64_to_float128( long long );
135 #endif
136
137 /*
138 -------------------------------------------------------------------------------
139 Software IEC/IEEE single-precision conversion routines.
140 -------------------------------------------------------------------------------
141 */
142 int float32_to_int32( float32 );
143 int float32_to_int32_round_to_zero( float32 );
144 unsigned int float32_to_uint32_round_to_zero( float32 );
145 long long float32_to_int64( float32 );
146 long long float32_to_int64_round_to_zero( float32 );
147 float64 float32_to_float64( float32 );
148 #ifdef FLOATX80
149 floatx80 float32_to_floatx80( float32 );
150 #endif
151 #ifdef FLOAT128
152 float128 float32_to_float128( float32 );
153 #endif
154
155 /*
156 -------------------------------------------------------------------------------
157 Software IEC/IEEE single-precision operations.
158 -------------------------------------------------------------------------------
159 */
160 float32 float32_round_to_int( float32 );
161 float32 float32_add( float32, float32 );
162 float32 float32_sub( float32, float32 );
163 float32 float32_mul( float32, float32 );
164 float32 float32_div( float32, float32 );
165 float32 float32_rem( float32, float32 );
166 float32 float32_sqrt( float32 );
167 flag float32_eq( float32, float32 );
168 flag float32_le( float32, float32 );
169 flag float32_lt( float32, float32 );
170 flag float32_eq_signaling( float32, float32 );
171 flag float32_le_quiet( float32, float32 );
172 flag float32_lt_quiet( float32, float32 );
173 flag float32_is_signaling_nan( float32 );
174
175 /*
176 -------------------------------------------------------------------------------
177 Software IEC/IEEE double-precision conversion routines.
178 -------------------------------------------------------------------------------
179 */
180 int float64_to_int32( float64 );
181 int float64_to_int32_round_to_zero( float64 );
182 unsigned int float64_to_uint32_round_to_zero( float64 );
183 long long float64_to_int64( float64 );
184 long long float64_to_int64_round_to_zero( float64 );
185 float32 float64_to_float32( float64 );
186 #ifdef FLOATX80
187 floatx80 float64_to_floatx80( float64 );
188 #endif
189 #ifdef FLOAT128
190 float128 float64_to_float128( float64 );
191 #endif
192
193 /*
194 -------------------------------------------------------------------------------
195 Software IEC/IEEE double-precision operations.
196 -------------------------------------------------------------------------------
197 */
198 float64 float64_round_to_int( float64 );
199 float64 float64_add( float64, float64 );
200 float64 float64_sub( float64, float64 );
201 float64 float64_mul( float64, float64 );
202 float64 float64_div( float64, float64 );
203 float64 float64_rem( float64, float64 );
204 float64 float64_sqrt( float64 );
205 flag float64_eq( float64, float64 );
206 flag float64_le( float64, float64 );
207 flag float64_lt( float64, float64 );
208 flag float64_eq_signaling( float64, float64 );
209 flag float64_le_quiet( float64, float64 );
210 flag float64_lt_quiet( float64, float64 );
211 flag float64_is_signaling_nan( float64 );
212
213 #ifdef FLOATX80
214
215 /*
216 -------------------------------------------------------------------------------
217 Software IEC/IEEE extended double-precision conversion routines.
218 -------------------------------------------------------------------------------
219 */
220 int floatx80_to_int32( floatx80 );
221 int floatx80_to_int32_round_to_zero( floatx80 );
222 long long floatx80_to_int64( floatx80 );
223 long long floatx80_to_int64_round_to_zero( floatx80 );
224 float32 floatx80_to_float32( floatx80 );
225 float64 floatx80_to_float64( floatx80 );
226 #ifdef FLOAT128
227 float128 floatx80_to_float128( floatx80 );
228 #endif
229
230 /*
231 -------------------------------------------------------------------------------
232 Software IEC/IEEE extended double-precision rounding precision. Valid
233 values are 32, 64, and 80.
234 -------------------------------------------------------------------------------
235 */
236 extern int floatx80_rounding_precision;
237
238 /*
239 -------------------------------------------------------------------------------
240 Software IEC/IEEE extended double-precision operations.
241 -------------------------------------------------------------------------------
242 */
243 floatx80 floatx80_round_to_int( floatx80 );
244 floatx80 floatx80_add( floatx80, floatx80 );
245 floatx80 floatx80_sub( floatx80, floatx80 );
246 floatx80 floatx80_mul( floatx80, floatx80 );
247 floatx80 floatx80_div( floatx80, floatx80 );
248 floatx80 floatx80_rem( floatx80, floatx80 );
249 floatx80 floatx80_sqrt( floatx80 );
250 flag floatx80_eq( floatx80, floatx80 );
251 flag floatx80_le( floatx80, floatx80 );
252 flag floatx80_lt( floatx80, floatx80 );
253 flag floatx80_eq_signaling( floatx80, floatx80 );
254 flag floatx80_le_quiet( floatx80, floatx80 );
255 flag floatx80_lt_quiet( floatx80, floatx80 );
256 flag floatx80_is_signaling_nan( floatx80 );
257
258 #endif
259
260 #ifdef FLOAT128
261
262 /*
263 -------------------------------------------------------------------------------
264 Software IEC/IEEE quadruple-precision conversion routines.
265 -------------------------------------------------------------------------------
266 */
267 int float128_to_int32( float128 );
268 int float128_to_int32_round_to_zero( float128 );
269 long long float128_to_int64( float128 );
270 long long float128_to_int64_round_to_zero( float128 );
271 float32 float128_to_float32( float128 );
272 float64 float128_to_float64( float128 );
273 #ifdef FLOATX80
274 floatx80 float128_to_floatx80( float128 );
275 #endif
276
277 /*
278 -------------------------------------------------------------------------------
279 Software IEC/IEEE quadruple-precision operations.
280 -------------------------------------------------------------------------------
281 */
282 float128 float128_round_to_int( float128 );
283 float128 float128_add( float128, float128 );
284 float128 float128_sub( float128, float128 );
285 float128 float128_mul( float128, float128 );
286 float128 float128_div( float128, float128 );
287 float128 float128_rem( float128, float128 );
288 float128 float128_sqrt( float128 );
289 flag float128_eq( float128, float128 );
290 flag float128_le( float128, float128 );
291 flag float128_lt( float128, float128 );
292 flag float128_eq_signaling( float128, float128 );
293 flag float128_le_quiet( float128, float128 );
294 flag float128_lt_quiet( float128, float128 );
295 flag float128_is_signaling_nan( float128 );
296
297 #endif
298