gdb/doublest.h

   1 /* Floating point definitions for GDB.
   2
   3    Copyright (C) 1986, 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995,
   4    1996, 1997, 1998, 1999, 2000, 2001, 2003, 2005, 2006
   5    Free Software Foundation, Inc.
   6
   7    This file is part of GDB.
   8
   9    This program is free software; you can redistribute it and/or modify
  10    it under the terms of the GNU General Public License as published by
  11    the Free Software Foundation; either version 2 of the License, or
  12    (at your option) any later version.
  13
  14    This program is distributed in the hope that it will be useful,
  15    but WITHOUT ANY WARRANTY; without even the implied warranty of
  16    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17    GNU General Public License for more details.
  18
  19    You should have received a copy of the GNU General Public License
  20    along with this program; if not, write to the Free Software
  21    Foundation, Inc., 51 Franklin Street, Fifth Floor,
  22    Boston, MA 02110-1301, USA.  */
  23
  24 #ifndef DOUBLEST_H
  25 #define DOUBLEST_H
  26
  27 struct type;
  28 struct floatformat;
  29
  30 /* Setup definitions for host and target floating point formats.  We need to
  31    consider the format for `float', `double', and `long double' for both target
  32    and host.  We need to do this so that we know what kind of conversions need
  33    to be done when converting target numbers to and from the hosts DOUBLEST
  34    data type.  */
  35
  36 /* This is used to indicate that we don't know the format of the floating point
  37    number.  Typically, this is useful for native ports, where the actual format
  38    is irrelevant, since no conversions will be taking place.  */
  39
  40 #include "floatformat.h"        /* For struct floatformat */
  41
  42 /* Use `long double' if the host compiler supports it.  (Note that this is not
  43    necessarily any longer than `double'.  On SunOS/gcc, it's the same as
  44    double.)  This is necessary because GDB internally converts all floating
  45    point values to the widest type supported by the host.
  46
  47    There are problems however, when the target `long double' is longer than the
  48    host's `long double'.  In general, we'll probably reduce the precision of
  49    any such values and print a warning.  */
  50
  51 #if (defined HAVE_LONG_DOUBLE && defined PRINTF_HAS_LONG_DOUBLE \
  52      && defined SCANF_HAS_LONG_DOUBLE)
  53 typedef long double DOUBLEST;
  54 # define DOUBLEST_PRINT_FORMAT "%Lg"
  55 # define DOUBLEST_SCAN_FORMAT "%Lg"
  56 #else
  57 typedef double DOUBLEST;
  58 # define DOUBLEST_PRINT_FORMAT "%g"
  59 # define DOUBLEST_SCAN_FORMAT "%lg"
  60 /* If we can't scan or print long double, we don't want to use it
  61    anywhere.  */
  62 # undef HAVE_LONG_DOUBLE
  63 # undef PRINTF_HAS_LONG_DOUBLE
  64 # undef SCANF_HAS_LONG_DOUBLE
  65 #endif
  66
  67 extern void floatformat_to_doublest (const struct floatformat *,
  68                                      const void *in, DOUBLEST *out);
  69 extern void floatformat_from_doublest (const struct floatformat *,
  70                                        const DOUBLEST *in, void *out);
  71
  72 extern int floatformat_is_negative (const struct floatformat *,
  73                                     const bfd_byte *);
  74 extern int floatformat_is_nan (const struct floatformat *, const bfd_byte *);
  75 extern const char *floatformat_mantissa (const struct floatformat *,
  76                                          const bfd_byte *);
  77
  78 /* These functions have been replaced by extract_typed_floating and
  79    store_typed_floating.
  80
  81    Most calls are passing in TYPE_LENGTH (TYPE) so can be changed to
  82    just pass the TYPE.  The remainder pass in the length of a
  83    register, those calls should instead pass in the floating point
  84    type that corresponds to that length.  */
  85
  86 extern DOUBLEST deprecated_extract_floating (const void *addr, int len);
  87 extern void deprecated_store_floating (void *addr, int len, DOUBLEST val);
  88
  89 /* Given TYPE, return its floatformat.  TYPE_FLOATFORMAT() may return
  90    NULL.  type_floatformat() detects that and returns a floatformat
  91    based on the type size when FLOATFORMAT is NULL.  */
  92
  93 const struct floatformat *floatformat_from_type (const struct type *type);
  94
  95 extern DOUBLEST extract_typed_floating (const void *addr,
  96                                         const struct type *type);
  97 extern void store_typed_floating (void *addr, const struct type *type,
  98                                   DOUBLEST val);
  99 extern void convert_typed_floating (const void *from,
 100                                     const struct type *from_type,
 101                                     void *to, const struct type *to_type);
 102
 103 /* Table of convenient float-formats.  */
 104 extern const struct floatformat *floatformat_ieee_single[BFD_ENDIAN_UNKNOWN];
 105 extern const struct floatformat *floatformat_ieee_double[BFD_ENDIAN_UNKNOWN];
 106 extern const struct floatformat *floatformat_ieee_quad[BFD_ENDIAN_UNKNOWN];
 107 extern const struct floatformat *floatformat_arm_ext[BFD_ENDIAN_UNKNOWN];
 108 extern const struct floatformat *floatformat_ia64_spill[BFD_ENDIAN_UNKNOWN];
 109
 110 #endif