xref: /dflybsd-src/contrib/mpfr/src/expm1.c (revision 2786097444a0124b5d33763854de247e230c6629)
14a238c70SJohn Marino /* mpfr_expm1 -- Compute exp(x)-1
24a238c70SJohn Marino 
3*ab6d115fSJohn Marino Copyright 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013 Free Software Foundation, Inc.
4*ab6d115fSJohn Marino Contributed by the AriC and Caramel projects, INRIA.
54a238c70SJohn Marino 
64a238c70SJohn Marino This file is part of the GNU MPFR Library.
74a238c70SJohn Marino 
84a238c70SJohn Marino The GNU MPFR Library is free software; you can redistribute it and/or modify
94a238c70SJohn Marino it under the terms of the GNU Lesser General Public License as published by
104a238c70SJohn Marino the Free Software Foundation; either version 3 of the License, or (at your
114a238c70SJohn Marino option) any later version.
124a238c70SJohn Marino 
134a238c70SJohn Marino The GNU MPFR Library is distributed in the hope that it will be useful, but
144a238c70SJohn Marino WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
154a238c70SJohn Marino or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public
164a238c70SJohn Marino License for more details.
174a238c70SJohn Marino 
184a238c70SJohn Marino You should have received a copy of the GNU Lesser General Public License
194a238c70SJohn Marino along with the GNU MPFR Library; see the file COPYING.LESSER.  If not, see
204a238c70SJohn Marino http://www.gnu.org/licenses/ or write to the Free Software Foundation, Inc.,
214a238c70SJohn Marino 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA. */
224a238c70SJohn Marino 
234a238c70SJohn Marino #define MPFR_NEED_LONGLONG_H
244a238c70SJohn Marino #include "mpfr-impl.h"
254a238c70SJohn Marino 
264a238c70SJohn Marino  /* The computation of expm1 is done by
274a238c70SJohn Marino     expm1(x)=exp(x)-1
284a238c70SJohn Marino  */
294a238c70SJohn Marino 
304a238c70SJohn Marino int
mpfr_expm1(mpfr_ptr y,mpfr_srcptr x,mpfr_rnd_t rnd_mode)314a238c70SJohn Marino mpfr_expm1 (mpfr_ptr y, mpfr_srcptr x , mpfr_rnd_t rnd_mode)
324a238c70SJohn Marino {
334a238c70SJohn Marino   int inexact;
344a238c70SJohn Marino   mpfr_exp_t ex;
354a238c70SJohn Marino   MPFR_SAVE_EXPO_DECL (expo);
364a238c70SJohn Marino 
374a238c70SJohn Marino   MPFR_LOG_FUNC
384a238c70SJohn Marino     (("x[%Pu]=%.*Rg rnd=%d", mpfr_get_prec (x), mpfr_log_prec, x, rnd_mode),
394a238c70SJohn Marino      ("y[%Pu]=%.*Rg inexact=%d", mpfr_get_prec (y), mpfr_log_prec, y,
404a238c70SJohn Marino       inexact));
414a238c70SJohn Marino 
424a238c70SJohn Marino   if (MPFR_UNLIKELY (MPFR_IS_SINGULAR (x)))
434a238c70SJohn Marino     {
444a238c70SJohn Marino       if (MPFR_IS_NAN (x))
454a238c70SJohn Marino         {
464a238c70SJohn Marino           MPFR_SET_NAN (y);
474a238c70SJohn Marino           MPFR_RET_NAN;
484a238c70SJohn Marino         }
494a238c70SJohn Marino       /* check for inf or -inf (expm1(-inf)=-1) */
504a238c70SJohn Marino       else if (MPFR_IS_INF (x))
514a238c70SJohn Marino         {
524a238c70SJohn Marino           if (MPFR_IS_POS (x))
534a238c70SJohn Marino             {
544a238c70SJohn Marino               MPFR_SET_INF (y);
554a238c70SJohn Marino               MPFR_SET_POS (y);
564a238c70SJohn Marino               MPFR_RET (0);
574a238c70SJohn Marino             }
584a238c70SJohn Marino           else
594a238c70SJohn Marino             return mpfr_set_si (y, -1, rnd_mode);
604a238c70SJohn Marino         }
614a238c70SJohn Marino       else
624a238c70SJohn Marino         {
634a238c70SJohn Marino           MPFR_ASSERTD (MPFR_IS_ZERO (x));
644a238c70SJohn Marino           MPFR_SET_ZERO (y);   /* expm1(+/- 0) = +/- 0 */
654a238c70SJohn Marino           MPFR_SET_SAME_SIGN (y, x);
664a238c70SJohn Marino           MPFR_RET (0);
674a238c70SJohn Marino         }
684a238c70SJohn Marino     }
694a238c70SJohn Marino 
704a238c70SJohn Marino   ex = MPFR_GET_EXP (x);
714a238c70SJohn Marino   if (ex < 0)
724a238c70SJohn Marino     {
734a238c70SJohn Marino       /* For -1 < x < 0, abs(expm1(x)-x) < x^2/2.
744a238c70SJohn Marino          For 0 < x < 1,  abs(expm1(x)-x) < x^2. */
754a238c70SJohn Marino       if (MPFR_IS_POS (x))
764a238c70SJohn Marino         MPFR_FAST_COMPUTE_IF_SMALL_INPUT (y, x, - ex, 0, 1, rnd_mode, {});
774a238c70SJohn Marino       else
784a238c70SJohn Marino         MPFR_FAST_COMPUTE_IF_SMALL_INPUT (y, x, - ex, 1, 0, rnd_mode, {});
794a238c70SJohn Marino     }
804a238c70SJohn Marino 
814a238c70SJohn Marino   MPFR_SAVE_EXPO_MARK (expo);
824a238c70SJohn Marino 
834a238c70SJohn Marino   if (MPFR_IS_NEG (x) && ex > 5)  /* x <= -32 */
844a238c70SJohn Marino     {
854a238c70SJohn Marino       mpfr_t minus_one, t;
864a238c70SJohn Marino       mpfr_exp_t err;
874a238c70SJohn Marino 
884a238c70SJohn Marino       mpfr_init2 (minus_one, 2);
894a238c70SJohn Marino       mpfr_init2 (t, 64);
904a238c70SJohn Marino       mpfr_set_si (minus_one, -1, MPFR_RNDN);
914a238c70SJohn Marino       mpfr_const_log2 (t, MPFR_RNDU); /* round upward since x is negative */
924a238c70SJohn Marino       mpfr_div (t, x, t, MPFR_RNDU); /* > x / ln(2) */
934a238c70SJohn Marino       err = mpfr_cmp_si (t, MPFR_EMIN_MIN >= -LONG_MAX ?
944a238c70SJohn Marino                          MPFR_EMIN_MIN : -LONG_MAX) <= 0 ?
954a238c70SJohn Marino         - (MPFR_EMIN_MIN >= -LONG_MAX ? MPFR_EMIN_MIN : -LONG_MAX) :
964a238c70SJohn Marino         - mpfr_get_si (t, MPFR_RNDU);
974a238c70SJohn Marino       /* exp(x) = 2^(x/ln(2))
984a238c70SJohn Marino                <= 2^max(MPFR_EMIN_MIN,-LONG_MAX,ceil(x/ln(2)+epsilon))
994a238c70SJohn Marino          with epsilon > 0 */
1004a238c70SJohn Marino       mpfr_clear (t);
1014a238c70SJohn Marino       MPFR_SMALL_INPUT_AFTER_SAVE_EXPO (y, minus_one, err, 0, 0, rnd_mode,
1024a238c70SJohn Marino                                         expo, { mpfr_clear (minus_one); });
1034a238c70SJohn Marino       mpfr_clear (minus_one);
1044a238c70SJohn Marino     }
1054a238c70SJohn Marino 
1064a238c70SJohn Marino   /* General case */
1074a238c70SJohn Marino   {
1084a238c70SJohn Marino     /* Declaration of the intermediary variable */
1094a238c70SJohn Marino     mpfr_t t;
1104a238c70SJohn Marino     /* Declaration of the size variable */
1114a238c70SJohn Marino     mpfr_prec_t Ny = MPFR_PREC(y);   /* target precision */
1124a238c70SJohn Marino     mpfr_prec_t Nt;                  /* working precision */
1134a238c70SJohn Marino     mpfr_exp_t err, exp_te;          /* error */
1144a238c70SJohn Marino     MPFR_ZIV_DECL (loop);
1154a238c70SJohn Marino 
1164a238c70SJohn Marino     /* compute the precision of intermediary variable */
1174a238c70SJohn Marino     /* the optimal number of bits : see algorithms.tex */
1184a238c70SJohn Marino     Nt = Ny + MPFR_INT_CEIL_LOG2 (Ny) + 6;
1194a238c70SJohn Marino 
1204a238c70SJohn Marino     /* if |x| is smaller than 2^(-e), we will loose about e bits in the
1214a238c70SJohn Marino        subtraction exp(x) - 1 */
1224a238c70SJohn Marino     if (ex < 0)
1234a238c70SJohn Marino       Nt += - ex;
1244a238c70SJohn Marino 
1254a238c70SJohn Marino     /* initialize auxiliary variable */
1264a238c70SJohn Marino     mpfr_init2 (t, Nt);
1274a238c70SJohn Marino 
1284a238c70SJohn Marino     /* First computation of expm1 */
1294a238c70SJohn Marino     MPFR_ZIV_INIT (loop, Nt);
1304a238c70SJohn Marino     for (;;)
1314a238c70SJohn Marino       {
1324a238c70SJohn Marino         MPFR_BLOCK_DECL (flags);
1334a238c70SJohn Marino 
1344a238c70SJohn Marino         /* exp(x) may overflow and underflow */
1354a238c70SJohn Marino         MPFR_BLOCK (flags, mpfr_exp (t, x, MPFR_RNDN));
1364a238c70SJohn Marino         if (MPFR_OVERFLOW (flags))
1374a238c70SJohn Marino           {
1384a238c70SJohn Marino             inexact = mpfr_overflow (y, rnd_mode, MPFR_SIGN_POS);
1394a238c70SJohn Marino             MPFR_SAVE_EXPO_UPDATE_FLAGS (expo, MPFR_FLAGS_OVERFLOW);
1404a238c70SJohn Marino             break;
1414a238c70SJohn Marino           }
1424a238c70SJohn Marino         else if (MPFR_UNDERFLOW (flags))
1434a238c70SJohn Marino           {
1444a238c70SJohn Marino             inexact = mpfr_set_si (y, -1, rnd_mode);
1454a238c70SJohn Marino             MPFR_ASSERTD (inexact == 0);
1464a238c70SJohn Marino             inexact = -1;
1474a238c70SJohn Marino             if (MPFR_IS_LIKE_RNDZ (rnd_mode, 1))
1484a238c70SJohn Marino               {
1494a238c70SJohn Marino                 inexact = 1;
1504a238c70SJohn Marino                 mpfr_nexttozero (y);
1514a238c70SJohn Marino               }
1524a238c70SJohn Marino             break;
1534a238c70SJohn Marino           }
1544a238c70SJohn Marino 
1554a238c70SJohn Marino         exp_te = MPFR_GET_EXP (t);         /* FIXME: exp(x) may overflow! */
1564a238c70SJohn Marino         mpfr_sub_ui (t, t, 1, MPFR_RNDN);   /* exp(x)-1 */
1574a238c70SJohn Marino 
1584a238c70SJohn Marino         /* error estimate */
1594a238c70SJohn Marino         /*err=Nt-(__gmpfr_ceil_log2(1+pow(2,MPFR_EXP(te)-MPFR_EXP(t))));*/
1604a238c70SJohn Marino         err = Nt - (MAX (exp_te - MPFR_GET_EXP (t), 0) + 1);
1614a238c70SJohn Marino 
1624a238c70SJohn Marino         if (MPFR_LIKELY (MPFR_CAN_ROUND (t, err, Ny, rnd_mode)))
1634a238c70SJohn Marino           {
1644a238c70SJohn Marino             inexact = mpfr_set (y, t, rnd_mode);
1654a238c70SJohn Marino             break;
1664a238c70SJohn Marino           }
1674a238c70SJohn Marino 
1684a238c70SJohn Marino         /* increase the precision */
1694a238c70SJohn Marino         MPFR_ZIV_NEXT (loop, Nt);
1704a238c70SJohn Marino         mpfr_set_prec (t, Nt);
1714a238c70SJohn Marino       }
1724a238c70SJohn Marino     MPFR_ZIV_FREE (loop);
1734a238c70SJohn Marino 
1744a238c70SJohn Marino     mpfr_clear (t);
1754a238c70SJohn Marino   }
1764a238c70SJohn Marino 
1774a238c70SJohn Marino   MPFR_SAVE_EXPO_FREE (expo);
1784a238c70SJohn Marino   return mpfr_check_range (y, inexact, rnd_mode);
1794a238c70SJohn Marino }
180