1 /* IEEE floating point support routines, for GDB, the GNU Debugger.
2 Copyright (C) 1991-2024 Free Software Foundation, Inc.
4 This file is part of GDB.
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2 of the License, or
9 (at your option) any later version.
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with this program; if not, write to the Free Software
18 Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston, MA 02110-1301, USA. */
20 /* This is needed to pick up the NAN macro on some systems. */
35 /* On some platforms, <float.h> provides DBL_QNAN. */
41 #include "libiberty.h"
42 #include "floatformat.h"
46 #define INFINITY HUGE_VAL
48 #define INFINITY (1.0 / 0.0)
56 #define NAN (0.0 / 0.0)
60 static int mant_bits_set (const struct floatformat
*, const unsigned char *);
61 static unsigned long get_field (const unsigned char *,
62 enum floatformat_byteorders
,
66 static int floatformat_always_valid (const struct floatformat
*fmt
,
70 floatformat_always_valid (const struct floatformat
*fmt ATTRIBUTE_UNUSED
,
71 const void *from ATTRIBUTE_UNUSED
)
76 /* The odds that CHAR_BIT will be anything but 8 are low enough that I'm not
77 going to bother with trying to muck around with whether it is defined in
78 a system header, what we do if not, etc. */
79 #define FLOATFORMAT_CHAR_BIT 8
81 /* floatformats for IEEE half, single, double and quad, big and little endian. */
82 const struct floatformat floatformat_ieee_half_big
=
84 floatformat_big
, 16, 0, 1, 5, 15, 31, 6, 10,
85 floatformat_intbit_no
,
86 "floatformat_ieee_half_big",
87 floatformat_always_valid
,
90 const struct floatformat floatformat_ieee_half_little
=
92 floatformat_little
, 16, 0, 1, 5, 15, 31, 6, 10,
93 floatformat_intbit_no
,
94 "floatformat_ieee_half_little",
95 floatformat_always_valid
,
98 const struct floatformat floatformat_ieee_single_big
=
100 floatformat_big
, 32, 0, 1, 8, 127, 255, 9, 23,
101 floatformat_intbit_no
,
102 "floatformat_ieee_single_big",
103 floatformat_always_valid
,
106 const struct floatformat floatformat_ieee_single_little
=
108 floatformat_little
, 32, 0, 1, 8, 127, 255, 9, 23,
109 floatformat_intbit_no
,
110 "floatformat_ieee_single_little",
111 floatformat_always_valid
,
114 const struct floatformat floatformat_ieee_double_big
=
116 floatformat_big
, 64, 0, 1, 11, 1023, 2047, 12, 52,
117 floatformat_intbit_no
,
118 "floatformat_ieee_double_big",
119 floatformat_always_valid
,
122 const struct floatformat floatformat_ieee_double_little
=
124 floatformat_little
, 64, 0, 1, 11, 1023, 2047, 12, 52,
125 floatformat_intbit_no
,
126 "floatformat_ieee_double_little",
127 floatformat_always_valid
,
130 const struct floatformat floatformat_ieee_quad_big
=
132 floatformat_big
, 128, 0, 1, 15, 16383, 0x7fff, 16, 112,
133 floatformat_intbit_no
,
134 "floatformat_ieee_quad_big",
135 floatformat_always_valid
,
138 const struct floatformat floatformat_ieee_quad_little
=
140 floatformat_little
, 128, 0, 1, 15, 16383, 0x7fff, 16, 112,
141 floatformat_intbit_no
,
142 "floatformat_ieee_quad_little",
143 floatformat_always_valid
,
147 /* floatformat for IEEE double, little endian byte order, with big endian word
148 ordering, as on the ARM. */
150 const struct floatformat floatformat_ieee_double_littlebyte_bigword
=
152 floatformat_littlebyte_bigword
, 64, 0, 1, 11, 1023, 2047, 12, 52,
153 floatformat_intbit_no
,
154 "floatformat_ieee_double_littlebyte_bigword",
155 floatformat_always_valid
,
159 /* floatformat for VAX. Not quite IEEE, but close enough. */
161 const struct floatformat floatformat_vax_f
=
163 floatformat_vax
, 32, 0, 1, 8, 129, 0, 9, 23,
164 floatformat_intbit_no
,
166 floatformat_always_valid
,
169 const struct floatformat floatformat_vax_d
=
171 floatformat_vax
, 64, 0, 1, 8, 129, 0, 9, 55,
172 floatformat_intbit_no
,
174 floatformat_always_valid
,
177 const struct floatformat floatformat_vax_g
=
179 floatformat_vax
, 64, 0, 1, 11, 1025, 0, 12, 52,
180 floatformat_intbit_no
,
182 floatformat_always_valid
,
186 static int floatformat_i387_ext_is_valid (const struct floatformat
*fmt
,
190 floatformat_i387_ext_is_valid (const struct floatformat
*fmt
, const void *from
)
192 /* In the i387 double-extended format, if the exponent is all ones,
193 then the integer bit must be set. If the exponent is neither 0
194 nor ~0, the intbit must also be set. Only if the exponent is
195 zero can it be zero, and then it must be zero. */
196 unsigned long exponent
, int_bit
;
197 const unsigned char *ufrom
= (const unsigned char *) from
;
199 exponent
= get_field (ufrom
, fmt
->byteorder
, fmt
->totalsize
,
200 fmt
->exp_start
, fmt
->exp_len
);
201 int_bit
= get_field (ufrom
, fmt
->byteorder
, fmt
->totalsize
,
204 if ((exponent
== 0) != (int_bit
== 0))
210 const struct floatformat floatformat_i387_ext
=
212 floatformat_little
, 80, 0, 1, 15, 0x3fff, 0x7fff, 16, 64,
213 floatformat_intbit_yes
,
214 "floatformat_i387_ext",
215 floatformat_i387_ext_is_valid
,
218 const struct floatformat floatformat_m68881_ext
=
220 /* Note that the bits from 16 to 31 are unused. */
221 floatformat_big
, 96, 0, 1, 15, 0x3fff, 0x7fff, 32, 64,
222 floatformat_intbit_yes
,
223 "floatformat_m68881_ext",
224 floatformat_always_valid
,
227 const struct floatformat floatformat_i960_ext
=
229 /* Note that the bits from 0 to 15 are unused. */
230 floatformat_little
, 96, 16, 17, 15, 0x3fff, 0x7fff, 32, 64,
231 floatformat_intbit_yes
,
232 "floatformat_i960_ext",
233 floatformat_always_valid
,
236 const struct floatformat floatformat_m88110_ext
=
238 floatformat_big
, 80, 0, 1, 15, 0x3fff, 0x7fff, 16, 64,
239 floatformat_intbit_yes
,
240 "floatformat_m88110_ext",
241 floatformat_always_valid
,
244 const struct floatformat floatformat_m88110_harris_ext
=
246 /* Harris uses raw format 128 bytes long, but the number is just an ieee
247 double, and the last 64 bits are wasted. */
248 floatformat_big
,128, 0, 1, 11, 0x3ff, 0x7ff, 12, 52,
249 floatformat_intbit_no
,
250 "floatformat_m88110_ext_harris",
251 floatformat_always_valid
,
254 const struct floatformat floatformat_arm_ext_big
=
256 /* Bits 1 to 16 are unused. */
257 floatformat_big
, 96, 0, 17, 15, 0x3fff, 0x7fff, 32, 64,
258 floatformat_intbit_yes
,
259 "floatformat_arm_ext_big",
260 floatformat_always_valid
,
263 const struct floatformat floatformat_arm_ext_littlebyte_bigword
=
265 /* Bits 1 to 16 are unused. */
266 floatformat_littlebyte_bigword
, 96, 0, 17, 15, 0x3fff, 0x7fff, 32, 64,
267 floatformat_intbit_yes
,
268 "floatformat_arm_ext_littlebyte_bigword",
269 floatformat_always_valid
,
272 const struct floatformat floatformat_ia64_spill_big
=
274 floatformat_big
, 128, 0, 1, 17, 65535, 0x1ffff, 18, 64,
275 floatformat_intbit_yes
,
276 "floatformat_ia64_spill_big",
277 floatformat_always_valid
,
280 const struct floatformat floatformat_ia64_spill_little
=
282 floatformat_little
, 128, 0, 1, 17, 65535, 0x1ffff, 18, 64,
283 floatformat_intbit_yes
,
284 "floatformat_ia64_spill_little",
285 floatformat_always_valid
,
290 floatformat_ibm_long_double_is_valid (const struct floatformat
*fmt
,
293 const unsigned char *ufrom
= (const unsigned char *) from
;
294 const struct floatformat
*hfmt
= fmt
->split_half
;
295 long top_exp
, bot_exp
;
298 top_exp
= get_field (ufrom
, hfmt
->byteorder
, hfmt
->totalsize
,
299 hfmt
->exp_start
, hfmt
->exp_len
);
300 bot_exp
= get_field (ufrom
+ 8, hfmt
->byteorder
, hfmt
->totalsize
,
301 hfmt
->exp_start
, hfmt
->exp_len
);
303 if ((unsigned long) top_exp
== hfmt
->exp_nan
)
304 top_nan
= mant_bits_set (hfmt
, ufrom
);
306 /* A NaN is valid with any low part. */
310 /* An infinity, zero or denormal requires low part 0 (positive or
312 if ((unsigned long) top_exp
== hfmt
->exp_nan
|| top_exp
== 0)
317 return !mant_bits_set (hfmt
, ufrom
+ 8);
320 /* The top part is now a finite normal value. The long double value
321 is the sum of the two parts, and the top part must equal the
322 result of rounding the long double value to nearest double. Thus
323 the bottom part must be <= 0.5ulp of the top part in absolute
324 value, and if it is < 0.5ulp then the long double is definitely
326 if (bot_exp
< top_exp
- 53)
328 if (bot_exp
> top_exp
- 53 && bot_exp
!= 0)
332 /* The bottom part is 0 or denormal. Determine which, and if
333 denormal the first two set bits. */
334 int first_bit
= -1, second_bit
= -1, cur_bit
;
335 for (cur_bit
= 0; (unsigned int) cur_bit
< hfmt
->man_len
; cur_bit
++)
336 if (get_field (ufrom
+ 8, hfmt
->byteorder
, hfmt
->totalsize
,
337 hfmt
->man_start
+ cur_bit
, 1))
343 second_bit
= cur_bit
;
347 /* Bottom part 0 is OK. */
350 /* The real exponent of the bottom part is -first_bit. */
351 if (-first_bit
< top_exp
- 53)
353 if (-first_bit
> top_exp
- 53)
355 /* The bottom part is at least 0.5ulp of the top part. For this
356 to be OK, the bottom part must be exactly 0.5ulp (i.e. no
357 more bits set) and the top part must have last bit 0. */
358 if (second_bit
!= -1)
360 return !get_field (ufrom
, hfmt
->byteorder
, hfmt
->totalsize
,
361 hfmt
->man_start
+ hfmt
->man_len
- 1, 1);
365 /* The bottom part is at least 0.5ulp of the top part. For this
366 to be OK, it must be exactly 0.5ulp (i.e. no explicit bits
367 set) and the top part must have last bit 0. */
368 if (get_field (ufrom
, hfmt
->byteorder
, hfmt
->totalsize
,
369 hfmt
->man_start
+ hfmt
->man_len
- 1, 1))
371 return !mant_bits_set (hfmt
, ufrom
+ 8);
375 const struct floatformat floatformat_ibm_long_double_big
=
377 floatformat_big
, 128, 0, 1, 11, 1023, 2047, 12, 52,
378 floatformat_intbit_no
,
379 "floatformat_ibm_long_double_big",
380 floatformat_ibm_long_double_is_valid
,
381 &floatformat_ieee_double_big
384 const struct floatformat floatformat_ibm_long_double_little
=
386 floatformat_little
, 128, 0, 1, 11, 1023, 2047, 12, 52,
387 floatformat_intbit_no
,
388 "floatformat_ibm_long_double_little",
389 floatformat_ibm_long_double_is_valid
,
390 &floatformat_ieee_double_little
393 const struct floatformat floatformat_bfloat16_big
=
395 floatformat_big
, 16, 0, 1, 8, 127, 255, 9, 7,
396 floatformat_intbit_no
,
397 "floatformat_bfloat16_big",
398 floatformat_always_valid
,
402 const struct floatformat floatformat_bfloat16_little
=
404 floatformat_little
, 16, 0, 1, 8, 127, 255, 9, 7,
405 floatformat_intbit_no
,
406 "floatformat_bfloat16_little",
407 floatformat_always_valid
,
412 #define min(a, b) ((a) < (b) ? (a) : (b))
415 /* Return 1 if any bits are explicitly set in the mantissa of UFROM,
416 format FMT, 0 otherwise. */
418 mant_bits_set (const struct floatformat
*fmt
, const unsigned char *ufrom
)
420 unsigned int mant_bits
, mant_off
;
423 mant_off
= fmt
->man_start
;
424 mant_bits_left
= fmt
->man_len
;
425 while (mant_bits_left
> 0)
427 mant_bits
= min (mant_bits_left
, 32);
429 if (get_field (ufrom
, fmt
->byteorder
, fmt
->totalsize
,
430 mant_off
, mant_bits
) != 0)
433 mant_off
+= mant_bits
;
434 mant_bits_left
-= mant_bits
;
439 /* Extract a field which starts at START and is LEN bits long. DATA and
440 TOTAL_LEN are the thing we are extracting it from, in byteorder ORDER. */
442 get_field (const unsigned char *data
, enum floatformat_byteorders order
,
443 unsigned int total_len
, unsigned int start
, unsigned int len
)
445 unsigned long result
= 0;
446 unsigned int cur_byte
;
447 int lo_bit
, hi_bit
, cur_bitshift
= 0;
448 int nextbyte
= (order
== floatformat_little
) ? 1 : -1;
450 /* Start is in big-endian bit order! Fix that first. */
451 start
= total_len
- (start
+ len
);
453 /* Start at the least significant part of the field. */
454 if (order
== floatformat_little
)
455 cur_byte
= start
/ FLOATFORMAT_CHAR_BIT
;
457 cur_byte
= (total_len
- start
- 1) / FLOATFORMAT_CHAR_BIT
;
459 lo_bit
= start
% FLOATFORMAT_CHAR_BIT
;
460 hi_bit
= min (lo_bit
+ len
, FLOATFORMAT_CHAR_BIT
);
464 unsigned int shifted
= *(data
+ cur_byte
) >> lo_bit
;
465 unsigned int bits
= hi_bit
- lo_bit
;
466 unsigned int mask
= (1 << bits
) - 1;
467 result
|= (shifted
& mask
) << cur_bitshift
;
469 cur_bitshift
+= bits
;
470 cur_byte
+= nextbyte
;
472 hi_bit
= min (len
, FLOATFORMAT_CHAR_BIT
);
479 /* Convert from FMT to a double.
480 FROM is the address of the extended float.
481 Store the double in *TO. */
484 floatformat_to_double (const struct floatformat
*fmt
,
485 const void *from
, double *to
)
487 const unsigned char *ufrom
= (const unsigned char *) from
;
491 unsigned int mant_bits
, mant_off
;
494 /* Split values are not handled specially, since the top half has
495 the correctly rounded double value (in the only supported case of
498 exponent
= get_field (ufrom
, fmt
->byteorder
, fmt
->totalsize
,
499 fmt
->exp_start
, fmt
->exp_len
);
501 /* If the exponent indicates a NaN, we don't have information to
502 decide what to do. So we handle it like IEEE, except that we
503 don't try to preserve the type of NaN. FIXME. */
504 if ((unsigned long) exponent
== fmt
->exp_nan
)
506 int nan
= mant_bits_set (fmt
, ufrom
);
508 /* On certain systems (such as GNU/Linux), the use of the
509 INFINITY macro below may generate a warning that cannot be
510 silenced due to a bug in GCC (PR preprocessor/11931). The
511 preprocessor fails to recognise the __extension__ keyword in
512 conjunction with the GNU/C99 extension for hexadecimal
513 floating point constants and will issue a warning when
514 compiling with -pedantic. */
520 if (get_field (ufrom
, fmt
->byteorder
, fmt
->totalsize
, fmt
->sign_start
, 1))
528 mant_bits_left
= fmt
->man_len
;
529 mant_off
= fmt
->man_start
;
532 /* Build the result algebraically. Might go infinite, underflow, etc;
535 /* For denorms use minimum exponent. */
537 exponent
= 1 - fmt
->exp_bias
;
540 exponent
-= fmt
->exp_bias
;
542 /* If this format uses a hidden bit, explicitly add it in now.
543 Otherwise, increment the exponent by one to account for the
546 if (fmt
->intbit
== floatformat_intbit_no
)
547 dto
= ldexp (1.0, exponent
);
552 while (mant_bits_left
> 0)
554 mant_bits
= min (mant_bits_left
, 32);
556 mant
= get_field (ufrom
, fmt
->byteorder
, fmt
->totalsize
,
557 mant_off
, mant_bits
);
559 dto
+= ldexp ((double) mant
, exponent
- mant_bits
);
560 exponent
-= mant_bits
;
561 mant_off
+= mant_bits
;
562 mant_bits_left
-= mant_bits
;
565 /* Negate it if negative. */
566 if (get_field (ufrom
, fmt
->byteorder
, fmt
->totalsize
, fmt
->sign_start
, 1))
571 static void put_field (unsigned char *, enum floatformat_byteorders
,
577 /* Set a field which starts at START and is LEN bits long. DATA and
578 TOTAL_LEN are the thing we are extracting it from, in byteorder ORDER. */
580 put_field (unsigned char *data
, enum floatformat_byteorders order
,
581 unsigned int total_len
, unsigned int start
, unsigned int len
,
582 unsigned long stuff_to_put
)
584 unsigned int cur_byte
;
586 int nextbyte
= (order
== floatformat_little
) ? 1 : -1;
588 /* Start is in big-endian bit order! Fix that first. */
589 start
= total_len
- (start
+ len
);
591 /* Start at the least significant part of the field. */
592 if (order
== floatformat_little
)
593 cur_byte
= start
/ FLOATFORMAT_CHAR_BIT
;
595 cur_byte
= (total_len
- start
- 1) / FLOATFORMAT_CHAR_BIT
;
597 lo_bit
= start
% FLOATFORMAT_CHAR_BIT
;
598 hi_bit
= min (lo_bit
+ len
, FLOATFORMAT_CHAR_BIT
);
602 unsigned char *byte_ptr
= data
+ cur_byte
;
603 unsigned int bits
= hi_bit
- lo_bit
;
604 unsigned int mask
= ((1 << bits
) - 1) << lo_bit
;
605 *byte_ptr
= (*byte_ptr
& ~mask
) | ((stuff_to_put
<< lo_bit
) & mask
);
606 stuff_to_put
>>= bits
;
608 cur_byte
+= nextbyte
;
610 hi_bit
= min (len
, FLOATFORMAT_CHAR_BIT
);
615 /* The converse: convert the double *FROM to an extended float
616 and store where TO points. Neither FROM nor TO have any alignment
620 floatformat_from_double (const struct floatformat
*fmt
,
621 const double *from
, void *to
)
626 unsigned int mant_bits
, mant_off
;
628 unsigned char *uto
= (unsigned char *) to
;
631 memset (uto
, 0, fmt
->totalsize
/ FLOATFORMAT_CHAR_BIT
);
633 /* Split values are not handled specially, since a bottom half of
634 zero is correct for any value representable as double (in the
635 only supported case of split values). */
637 /* If negative, set the sign bit. */
640 put_field (uto
, fmt
->byteorder
, fmt
->totalsize
, fmt
->sign_start
, 1, 1);
653 put_field (uto
, fmt
->byteorder
, fmt
->totalsize
, fmt
->exp_start
,
654 fmt
->exp_len
, fmt
->exp_nan
);
655 /* Be sure it's not infinity, but NaN value is irrelevant. */
656 put_field (uto
, fmt
->byteorder
, fmt
->totalsize
, fmt
->man_start
,
661 if (dfrom
+ dfrom
== dfrom
)
663 /* This can only happen for an infinite value (or zero, which we
664 already handled above). */
665 put_field (uto
, fmt
->byteorder
, fmt
->totalsize
, fmt
->exp_start
,
666 fmt
->exp_len
, fmt
->exp_nan
);
670 mant
= frexp (dfrom
, &exponent
);
671 if (exponent
+ fmt
->exp_bias
- 1 > 0)
672 put_field (uto
, fmt
->byteorder
, fmt
->totalsize
, fmt
->exp_start
,
673 fmt
->exp_len
, exponent
+ fmt
->exp_bias
- 1);
676 /* Handle a denormalized number. FIXME: What should we do for
678 put_field (uto
, fmt
->byteorder
, fmt
->totalsize
, fmt
->exp_start
,
680 mant
= ldexp (mant
, exponent
+ fmt
->exp_bias
- 1);
683 mant_bits_left
= fmt
->man_len
;
684 mant_off
= fmt
->man_start
;
685 while (mant_bits_left
> 0)
687 unsigned long mant_long
;
688 mant_bits
= mant_bits_left
< 32 ? mant_bits_left
: 32;
690 mant
*= 4294967296.0;
691 mant_long
= (unsigned long)mant
;
694 /* If the integer bit is implicit, and we are not creating a
695 denormalized number, then we need to discard it. */
696 if ((unsigned int) mant_bits_left
== fmt
->man_len
697 && fmt
->intbit
== floatformat_intbit_no
698 && exponent
+ fmt
->exp_bias
- 1 > 0)
700 mant_long
&= 0x7fffffff;
703 else if (mant_bits
< 32)
705 /* The bits we want are in the most significant MANT_BITS bits of
706 mant_long. Move them to the least significant. */
707 mant_long
>>= 32 - mant_bits
;
710 put_field (uto
, fmt
->byteorder
, fmt
->totalsize
,
711 mant_off
, mant_bits
, mant_long
);
712 mant_off
+= mant_bits
;
713 mant_bits_left
-= mant_bits
;
717 /* Return non-zero iff the data at FROM is a valid number in format FMT. */
720 floatformat_is_valid (const struct floatformat
*fmt
, const void *from
)
722 return fmt
->is_valid (fmt
, from
);
730 /* This is to be run on a host which uses IEEE floating point. */
737 floatformat_to_double (&floatformat_ieee_double_little
, &n
, &result
);
738 if ((n
!= result
&& (! isnan (n
) || ! isnan (result
)))
739 || (n
< 0 && result
>= 0)
740 || (n
>= 0 && result
< 0))
741 printf ("Differ(to): %.20g -> %.20g\n", n
, result
);
743 floatformat_from_double (&floatformat_ieee_double_little
, &n
, &result
);
744 if ((n
!= result
&& (! isnan (n
) || ! isnan (result
)))
745 || (n
< 0 && result
>= 0)
746 || (n
>= 0 && result
< 0))
747 printf ("Differ(from): %.20g -> %.20g\n", n
, result
);
753 floatformat_from_double (&floatformat_m68881_ext
, &n
, exten
);
754 floatformat_to_double (&floatformat_m68881_ext
, exten
, &result
);
756 printf ("Differ(to+from): %.20g -> %.20g\n", n
, result
);
761 /* This is to be run on a host which uses 68881 format. */
763 long double ex
= *(long double *)exten
;
765 printf ("Differ(from vs. extended): %.20g\n", n
);
778 ieee_test (234235.78907234);
780 ieee_test (-0.004321);
782 ieee_test (1.2E-316);
783 ieee_test (4.9406564584124654E-324);
784 ieee_test (- 4.9406564584124654E-324);
786 ieee_test (- INFINITY
);
788 ieee_test (INFINITY
);