3 ===============================================================================
5 This C header file is part of the SoftFloat IEC/IEEE Floating-point
6 Arithmetic Package, Release 2.
8 Written by John R. Hauser. This work was made possible in part by the
9 International Computer Science Institute, located at Suite 600, 1947 Center
10 Street, Berkeley, California 94704. Funding was partially provided by the
11 National Science Foundation under grant MIP-9311980. The original version
12 of this code was written as part of a project to build a fixed-point vector
13 processor in collaboration with the University of California at Berkeley,
14 overseen by Profs. Nelson Morgan and John Wawrzynek. More information
15 is available through the Web page `http://HTTP.CS.Berkeley.EDU/~jhauser/
16 arithmetic/softfloat.html'.
18 THIS SOFTWARE IS DISTRIBUTED AS IS, FOR FREE. Although reasonable effort
19 has been made to avoid it, THIS SOFTWARE MAY CONTAIN FAULTS THAT WILL AT
20 TIMES RESULT IN INCORRECT BEHAVIOR. USE OF THIS SOFTWARE IS RESTRICTED TO
21 PERSONS AND ORGANIZATIONS WHO CAN AND WILL TAKE FULL RESPONSIBILITY FOR ANY
22 AND ALL LOSSES, COSTS, OR OTHER PROBLEMS ARISING FROM ITS USE.
24 Derivative works are acceptable, even for commercial purposes, so long as
25 (1) they include prominent notice that the work is derivative, and (2) they
26 include prominent notice akin to these three paragraphs for those parts of
27 this code that are retained.
29 ===============================================================================
32 #ifndef __SOFTFLOAT_H__
33 #define __SOFTFLOAT_H__
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.
41 -------------------------------------------------------------------------------
46 -------------------------------------------------------------------------------
47 Software IEC/IEEE floating-point types.
48 -------------------------------------------------------------------------------
50 typedef unsigned long int float32;
51 typedef unsigned long long float64;
54 unsigned long long low;
58 -------------------------------------------------------------------------------
59 Software IEC/IEEE floating-point underflow tininess-detection mode.
60 -------------------------------------------------------------------------------
62 extern signed char float_detect_tininess;
64 float_tininess_after_rounding = 0,
65 float_tininess_before_rounding = 1
69 -------------------------------------------------------------------------------
70 Software IEC/IEEE floating-point rounding mode.
71 -------------------------------------------------------------------------------
73 extern signed char float_rounding_mode;
75 float_round_nearest_even = 0,
76 float_round_to_zero = 1,
82 -------------------------------------------------------------------------------
83 Software IEC/IEEE floating-point exception flags.
84 -------------------------------------------------------------------------------
85 extern signed char float_exception_flags;
87 float_flag_inexact = 1,
88 float_flag_underflow = 2,
89 float_flag_overflow = 4,
90 float_flag_divbyzero = 8,
91 float_flag_invalid = 16
94 ScottB: November 4, 1998
95 Changed the enumeration to match the bit order in the FPA11.
98 extern signed char float_exception_flags;
100 float_flag_invalid = 1,
101 float_flag_divbyzero = 2,
102 float_flag_overflow = 4,
103 float_flag_underflow = 8,
104 float_flag_inexact = 16
108 -------------------------------------------------------------------------------
109 Routine to raise any or all of the software IEC/IEEE floating-point
111 -------------------------------------------------------------------------------
113 void float_raise( signed char );
116 -------------------------------------------------------------------------------
117 Software IEC/IEEE integer-to-floating-point conversion routines.
118 -------------------------------------------------------------------------------
120 float32 int32_to_float32( signed int );
121 float64 int32_to_float64( signed int );
123 floatx80 int32_to_floatx80( signed int );
127 -------------------------------------------------------------------------------
128 Software IEC/IEEE single-precision conversion routines.
129 -------------------------------------------------------------------------------
131 signed int float32_to_int32( float32 );
132 signed int float32_to_int32_round_to_zero( float32 );
133 float64 float32_to_float64( float32 );
135 floatx80 float32_to_floatx80( float32 );
139 -------------------------------------------------------------------------------
140 Software IEC/IEEE single-precision operations.
141 -------------------------------------------------------------------------------
143 float32 float32_round_to_int( float32 );
144 float32 float32_add( float32, float32 );
145 float32 float32_sub( float32, float32 );
146 float32 float32_mul( float32, float32 );
147 float32 float32_div( float32, float32 );
148 float32 float32_rem( float32, float32 );
149 float32 float32_sqrt( float32 );
150 char float32_eq( float32, float32 );
151 char float32_le( float32, float32 );
152 char float32_lt( float32, float32 );
153 char float32_eq_signaling( float32, float32 );
154 char float32_le_quiet( float32, float32 );
155 char float32_lt_quiet( float32, float32 );
156 char float32_is_signaling_nan( float32 );
159 -------------------------------------------------------------------------------
160 Software IEC/IEEE double-precision conversion routines.
161 -------------------------------------------------------------------------------
163 signed int float64_to_int32( float64 );
164 signed int float64_to_int32_round_to_zero( float64 );
165 float32 float64_to_float32( float64 );
167 floatx80 float64_to_floatx80( float64 );
171 -------------------------------------------------------------------------------
172 Software IEC/IEEE double-precision operations.
173 -------------------------------------------------------------------------------
175 float64 float64_round_to_int( float64 );
176 float64 float64_add( float64, float64 );
177 float64 float64_sub( float64, float64 );
178 float64 float64_mul( float64, float64 );
179 float64 float64_div( float64, float64 );
180 float64 float64_rem( float64, float64 );
181 float64 float64_sqrt( float64 );
182 char float64_eq( float64, float64 );
183 char float64_le( float64, float64 );
184 char float64_lt( float64, float64 );
185 char float64_eq_signaling( float64, float64 );
186 char float64_le_quiet( float64, float64 );
187 char float64_lt_quiet( float64, float64 );
188 char float64_is_signaling_nan( float64 );
193 -------------------------------------------------------------------------------
194 Software IEC/IEEE extended double-precision conversion routines.
195 -------------------------------------------------------------------------------
197 signed int floatx80_to_int32( floatx80 );
198 signed int floatx80_to_int32_round_to_zero( floatx80 );
199 float32 floatx80_to_float32( floatx80 );
200 float64 floatx80_to_float64( floatx80 );
203 -------------------------------------------------------------------------------
204 Software IEC/IEEE extended double-precision rounding precision. Valid
205 values are 32, 64, and 80.
206 -------------------------------------------------------------------------------
208 extern signed char floatx80_rounding_precision;
211 -------------------------------------------------------------------------------
212 Software IEC/IEEE extended double-precision operations.
213 -------------------------------------------------------------------------------
215 floatx80 floatx80_round_to_int( floatx80 );
216 floatx80 floatx80_add( floatx80, floatx80 );
217 floatx80 floatx80_sub( floatx80, floatx80 );
218 floatx80 floatx80_mul( floatx80, floatx80 );
219 floatx80 floatx80_div( floatx80, floatx80 );
220 floatx80 floatx80_rem( floatx80, floatx80 );
221 floatx80 floatx80_sqrt( floatx80 );
222 char floatx80_eq( floatx80, floatx80 );
223 char floatx80_le( floatx80, floatx80 );
224 char floatx80_lt( floatx80, floatx80 );
225 char floatx80_eq_signaling( floatx80, floatx80 );
226 char floatx80_le_quiet( floatx80, floatx80 );
227 char floatx80_lt_quiet( floatx80, floatx80 );
228 char floatx80_is_signaling_nan( floatx80 );