gcc/real.h

   1 /* Definitions of floating-point access for GNU compiler.
   2    Copyright (C) 1989, 1991, 1994, 1996, 1997, 1998,
   3    1999, 2000, 2002 Free Software Foundation, Inc.
   4
   5 This file is part of GCC.
   6
   7 GCC is free software; you can redistribute it and/or modify it under
   8 the terms of the GNU General Public License as published by the Free
   9 Software Foundation; either version 2, or (at your option) any later
  10 version.
  11
  12 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
  13 WARRANTY; without even the implied warranty of MERCHANTABILITY or
  14 FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  15 for more details.
  16
  17 You should have received a copy of the GNU General Public License
  18 along with GCC; see the file COPYING.  If not, write to the Free
  19 Software Foundation, 59 Temple Place - Suite 330, Boston, MA
  20 02111-1307, USA.  */
  21
  22 #ifndef GCC_REAL_H
  23 #define GCC_REAL_H
  24
  25 /* Define codes for all the float formats that we know of.  */
  26 #define UNKNOWN_FLOAT_FORMAT 0
  27 #define IEEE_FLOAT_FORMAT 1
  28 #define VAX_FLOAT_FORMAT 2
  29 #define IBM_FLOAT_FORMAT 3
  30 #define C4X_FLOAT_FORMAT 4
  31
  32 /* Default to IEEE float if not specified.  Nearly all machines use it.  */
  33
  34 #ifndef TARGET_FLOAT_FORMAT
  35 #define TARGET_FLOAT_FORMAT     IEEE_FLOAT_FORMAT
  36 #endif
  37
  38 #ifndef HOST_FLOAT_FORMAT
  39 #define HOST_FLOAT_FORMAT       IEEE_FLOAT_FORMAT
  40 #endif
  41
  42 #ifndef INTEL_EXTENDED_IEEE_FORMAT
  43 #define INTEL_EXTENDED_IEEE_FORMAT 0
  44 #endif
  45
  46 /* If FLOAT_WORDS_BIG_ENDIAN and HOST_FLOAT_WORDS_BIG_ENDIAN are not defined
  47    in the header files, then this implies the word-endianness is the same as
  48    for integers.  */
  49
  50 /* This is defined 0 or 1, like WORDS_BIG_ENDIAN.  */
  51 #ifndef FLOAT_WORDS_BIG_ENDIAN
  52 #define FLOAT_WORDS_BIG_ENDIAN WORDS_BIG_ENDIAN
  53 #endif
  54
  55 /* This is defined 0 or 1, unlike HOST_WORDS_BIG_ENDIAN.  */
  56 #ifndef HOST_FLOAT_WORDS_BIG_ENDIAN
  57 #ifdef HOST_WORDS_BIG_ENDIAN
  58 #define HOST_FLOAT_WORDS_BIG_ENDIAN 1
  59 #else
  60 #define HOST_FLOAT_WORDS_BIG_ENDIAN 0
  61 #endif
  62 #endif
  63
  64 #ifndef LONG_DOUBLE_TYPE_SIZE
  65 #define LONG_DOUBLE_TYPE_SIZE 64
  66 #endif
  67 /* MAX_LONG_DOUBLE_TYPE_SIZE is a constant tested by #if.
  68    LONG_DOUBLE_TYPE_SIZE can vary at compiler run time.
  69    So long as macros like REAL_VALUE_TO_TARGET_LONG_DOUBLE cannot
  70    vary too, however, then XFmode and TFmode long double
  71    cannot both be supported at the same time.  */
  72 #ifndef MAX_LONG_DOUBLE_TYPE_SIZE
  73 #define MAX_LONG_DOUBLE_TYPE_SIZE LONG_DOUBLE_TYPE_SIZE
  74 #endif
  75
  76 /* **** Start of software floating point emulator interface macros **** */
  77
  78 /* REAL_VALUE_TYPE is an array of the minimum number of HOST_WIDE_INTs
  79    required to hold either a 96- or 160-bit extended precision floating
  80    point type.  This is true even if the maximum precision floating
  81    point type on the target is smaller.  */
  82 #if MAX_LONG_DOUBLE_TYPE_SIZE == 128 && !INTEL_EXTENDED_IEEE_FORMAT
  83 #define REAL_VALUE_TYPE_SIZE 160
  84 #else
  85 #define REAL_VALUE_TYPE_SIZE 96
  86 #endif
  87 #define REAL_WIDTH \
  88   (REAL_VALUE_TYPE_SIZE/HOST_BITS_PER_WIDE_INT \
  89    + (REAL_VALUE_TYPE_SIZE%HOST_BITS_PER_WIDE_INT ? 1 : 0)) /* round up */
  90 typedef struct {
  91   HOST_WIDE_INT r[REAL_WIDTH];
  92 } REAL_VALUE_TYPE;
  93
  94 /* Calculate the format for CONST_DOUBLE.  We need as many slots as
  95    are necessary to overlay a REAL_VALUE_TYPE on them.  This could be
  96    as many as five (32-bit HOST_WIDE_INT, 160-bit REAL_VALUE_TYPE).
  97
  98    A number of places assume that there are always at least two 'w'
  99    slots in a CONST_DOUBLE, so we provide them even if one would suffice.  */
 100
 101 #if REAL_WIDTH == 1
 102 # define CONST_DOUBLE_FORMAT     "0ww"
 103 #else
 104 # if REAL_WIDTH == 2
 105 #  define CONST_DOUBLE_FORMAT    "0ww"
 106 # else
 107 #  if REAL_WIDTH == 3
 108 #   define CONST_DOUBLE_FORMAT   "0www"
 109 #  else
 110 #   if REAL_WIDTH == 4
 111 #    define CONST_DOUBLE_FORMAT  "0wwww"
 112 #   else
 113 #    if REAL_WIDTH == 5
 114 #     define CONST_DOUBLE_FORMAT "0wwwww"
 115 #    else
 116       #error "REAL_WIDTH > 5 not supported"
 117 #    endif
 118 #   endif
 119 #  endif
 120 # endif
 121 #endif
 122
 123 extern unsigned int significand_size    PARAMS ((enum machine_mode));
 124
 125 #define REAL_ARITHMETIC(value, code, d1, d2) \
 126   earith (&(value), (code), &(d1), &(d2))
 127
 128 /* Declare functions in real.c.  */
 129 extern void earith              PARAMS ((REAL_VALUE_TYPE *, int,
 130                                        REAL_VALUE_TYPE *, REAL_VALUE_TYPE *));
 131 extern REAL_VALUE_TYPE etrunci  PARAMS ((REAL_VALUE_TYPE));
 132 extern REAL_VALUE_TYPE etruncui PARAMS ((REAL_VALUE_TYPE));
 133 extern REAL_VALUE_TYPE ereal_negate PARAMS ((REAL_VALUE_TYPE));
 134 extern HOST_WIDE_INT efixi      PARAMS ((REAL_VALUE_TYPE));
 135 extern unsigned HOST_WIDE_INT efixui PARAMS ((REAL_VALUE_TYPE));
 136 extern void ereal_from_int      PARAMS ((REAL_VALUE_TYPE *,
 137                                        HOST_WIDE_INT, HOST_WIDE_INT,
 138                                        enum machine_mode));
 139 extern void ereal_from_uint     PARAMS ((REAL_VALUE_TYPE *,
 140                                        unsigned HOST_WIDE_INT,
 141                                        unsigned HOST_WIDE_INT,
 142                                        enum machine_mode));
 143 extern void ereal_to_int        PARAMS ((HOST_WIDE_INT *, HOST_WIDE_INT *,
 144                                        REAL_VALUE_TYPE));
 145 extern REAL_VALUE_TYPE ereal_ldexp PARAMS ((REAL_VALUE_TYPE, int));
 146
 147 extern void etartdouble         PARAMS ((REAL_VALUE_TYPE, long *));
 148 extern void etarldouble         PARAMS ((REAL_VALUE_TYPE, long *));
 149 extern void etardouble          PARAMS ((REAL_VALUE_TYPE, long *));
 150 extern long etarsingle          PARAMS ((REAL_VALUE_TYPE));
 151 extern void ereal_to_decimal    PARAMS ((REAL_VALUE_TYPE, char *));
 152 extern int ereal_cmp            PARAMS ((REAL_VALUE_TYPE, REAL_VALUE_TYPE));
 153 extern int ereal_isneg          PARAMS ((REAL_VALUE_TYPE));
 154 extern REAL_VALUE_TYPE ereal_unto_float PARAMS ((long));
 155 extern REAL_VALUE_TYPE ereal_unto_double PARAMS ((long *));
 156 extern REAL_VALUE_TYPE ereal_from_float PARAMS ((HOST_WIDE_INT));
 157 extern REAL_VALUE_TYPE ereal_from_double PARAMS ((HOST_WIDE_INT *));
 158
 159 #define REAL_VALUES_EQUAL(x, y) (ereal_cmp ((x), (y)) == 0)
 160 /* true if x < y : */
 161 #define REAL_VALUES_LESS(x, y) (ereal_cmp ((x), (y)) == -1)
 162 #define REAL_VALUE_LDEXP(x, n) ereal_ldexp (x, n)
 163
 164 /* Compare two floating-point objects for bitwise identity.
 165    This is not the same as comparing for equality on IEEE hosts:
 166    -0.0 equals 0.0 but they are not identical, and conversely
 167    two NaNs might be identical but they cannot be equal.  */
 168 #define REAL_VALUES_IDENTICAL(x, y) \
 169   (!memcmp ((char *) &(x), (char *) &(y), sizeof (REAL_VALUE_TYPE)))
 170
 171 /* These return REAL_VALUE_TYPE: */
 172 #define REAL_VALUE_RNDZINT(x) (etrunci (x))
 173 #define REAL_VALUE_UNSIGNED_RNDZINT(x) (etruncui (x))
 174
 175 /* Truncate the floating-point value X to mode MODE.  */
 176 #define REAL_VALUE_TRUNCATE(mode, x)  real_value_truncate (mode, x)
 177 extern REAL_VALUE_TYPE real_value_truncate PARAMS ((enum machine_mode,
 178                                                  REAL_VALUE_TYPE));
 179
 180 /* These return HOST_WIDE_INT: */
 181 /* Convert a floating-point value to integer, rounding toward zero.  */
 182 #define REAL_VALUE_FIX(x) (efixi (x))
 183 /* Convert a floating-point value to unsigned integer, rounding
 184    toward zero.  */
 185 #define REAL_VALUE_UNSIGNED_FIX(x) (efixui (x))
 186
 187 /* Convert ASCII string S to floating point in mode M.
 188    Decimal input uses ATOF.  Hexadecimal uses HTOF.  */
 189 #define REAL_VALUE_ATOF(s,m) ereal_atof(s,m)
 190 #define REAL_VALUE_HTOF(s,m) ereal_atof(s,m)
 191
 192 #define REAL_VALUE_NEGATE ereal_negate
 193
 194 /* Compute the absolute value of a floating-point value X.  */
 195 #define REAL_VALUE_ABS(x) \
 196    (REAL_VALUE_NEGATIVE (x) ? REAL_VALUE_NEGATE (x) : (x))
 197
 198 /* Determine whether a floating-point value X is infinite.  */
 199 #define REAL_VALUE_ISINF(x) (target_isinf (x))
 200
 201 /* Determine whether a floating-point value X is a NaN.  */
 202 #define REAL_VALUE_ISNAN(x) (target_isnan (x))
 203
 204 /* Determine whether a floating-point value X is negative.  */
 205 #define REAL_VALUE_NEGATIVE(x) (target_negative (x))
 206
 207 /* Determine whether a floating-point value X is minus zero.  */
 208 #define REAL_VALUE_MINUS_ZERO(x) \
 209  ((ereal_cmp (x, dconst0) == 0) && (ereal_isneg (x) != 0 ))
 210
 211 #define REAL_VALUE_TO_INT ereal_to_int
 212
 213 /* Here the cast to HOST_WIDE_INT sign-extends arguments such as ~0.  */
 214 #define REAL_VALUE_FROM_INT(d, lo, hi, mode) \
 215   ereal_from_int (&d, (HOST_WIDE_INT) (lo), (HOST_WIDE_INT) (hi), mode)
 216
 217 #define REAL_VALUE_FROM_UNSIGNED_INT(d, lo, hi, mode) \
 218   ereal_from_uint (&d, lo, hi, mode)
 219
 220 /* IN is a REAL_VALUE_TYPE.  OUT is an array of longs.  */
 221 #define REAL_VALUE_TO_TARGET_LONG_DOUBLE(IN, OUT)               \
 222    (LONG_DOUBLE_TYPE_SIZE == 64 ? etardouble ((IN), (OUT))      \
 223     : LONG_DOUBLE_TYPE_SIZE == 96 ? etarldouble ((IN), (OUT))   \
 224     : LONG_DOUBLE_TYPE_SIZE == 128 ? etartdouble ((IN), (OUT))  \
 225     : abort ())
 226 #define REAL_VALUE_TO_TARGET_DOUBLE(IN, OUT) (etardouble ((IN), (OUT)))
 227
 228 /* IN is a REAL_VALUE_TYPE.  OUT is a long.  */
 229 #define REAL_VALUE_TO_TARGET_SINGLE(IN, OUT) ((OUT) = etarsingle ((IN)))
 230
 231 /* Inverse of REAL_VALUE_TO_TARGET_DOUBLE.  */
 232 #define REAL_VALUE_UNTO_TARGET_DOUBLE(d)  (ereal_unto_double (d))
 233
 234 /* Inverse of REAL_VALUE_TO_TARGET_SINGLE.  */
 235 #define REAL_VALUE_UNTO_TARGET_SINGLE(f)  (ereal_unto_float (f))
 236
 237 /* d is an array of HOST_WIDE_INT that holds a double precision
 238    value in the target computer's floating point format.  */
 239 #define REAL_VALUE_FROM_TARGET_DOUBLE(d)  (ereal_from_double (d))
 240
 241 /* f is a HOST_WIDE_INT containing a single precision target float value.  */
 242 #define REAL_VALUE_FROM_TARGET_SINGLE(f)  (ereal_from_float (f))
 243
 244 /* Conversions to decimal ASCII string.  */
 245 #define REAL_VALUE_TO_DECIMAL(r, fmt, s) (ereal_to_decimal (r, s))
 246
 247 /* **** End of software floating point emulator interface macros **** */
 248 \f
 249 /* Constant real values 0, 1, 2, and -1.  */
 250
 251 extern REAL_VALUE_TYPE dconst0;
 252 extern REAL_VALUE_TYPE dconst1;
 253 extern REAL_VALUE_TYPE dconst2;
 254 extern REAL_VALUE_TYPE dconstm1;
 255
 256 /* Given a CONST_DOUBLE in FROM, store into TO the value it represents.  */
 257 /* Function to return a real value (not a tree node)
 258    from a given integer constant.  */
 259 union tree_node;
 260 REAL_VALUE_TYPE real_value_from_int_cst PARAMS ((union tree_node *,
 261                                                 union tree_node *));
 262
 263 #define REAL_VALUE_FROM_CONST_DOUBLE(to, from)          \
 264   memcpy (&(to), &CONST_DOUBLE_LOW ((from)), sizeof (REAL_VALUE_TYPE))
 265
 266 /* Return a CONST_DOUBLE with value R and mode M.  */
 267
 268 #define CONST_DOUBLE_FROM_REAL_VALUE(r, m) immed_real_const_1 (r,  m)
 269 extern struct rtx_def *immed_real_const_1       PARAMS ((REAL_VALUE_TYPE,
 270                                                        enum machine_mode));
 271
 272 /* Replace R by 1/R in the given machine mode, if the result is exact.  */
 273 extern int exact_real_inverse   PARAMS ((enum machine_mode, REAL_VALUE_TYPE *));
 274 extern int target_isnan         PARAMS ((REAL_VALUE_TYPE));
 275 extern int target_isinf         PARAMS ((REAL_VALUE_TYPE));
 276 extern int target_negative      PARAMS ((REAL_VALUE_TYPE));
 277 extern void debug_real          PARAMS ((REAL_VALUE_TYPE));
 278 extern REAL_VALUE_TYPE ereal_atof PARAMS ((const char *, enum machine_mode));
 279
 280 #endif /* ! GCC_REAL_H */