Manpage of EXPM1

EXPM1

Section: Linux Programmer's Manual (3)
Updated: 2016-03-15
Index
 

NAME

expm1, expm1f, expm1l - exponential minus 1  

SYNOPSIS

#include <math.h>double expm1(double x);
float expm1f(float x);
long double expm1l(long double x);
Link with -lm.

Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

expm1():

_ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
    || _XOPEN_SOURCE >= 500
    || /* Since glibc 2.19: */ _DEFAULT_SOURCE
    || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

expm1f(), expm1l():
_ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
    || /* Since glibc 2.19: */ _DEFAULT_SOURCE
    || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
 

DESCRIPTION

These functions return a value equivalent to
    exp(x) - 1

The result is computed in a way that is accurate even if the value of xis near zero---a case where exp(x) - 1would be inaccurate due to subtraction of two numbers that are nearly equal.  

RETURN VALUE

On success, these functions return exp(x) - 1.

If xis a NaN, a NaN is returned.

If xis +0 (-0), +0 (-0) is returned.

If xis positive infinity, positive infinity is returned.

If xis negative infinity, -1 is returned.

If the result overflows, a range error occurs, and the functions return -HUGE_VAL, -HUGE_VALF, or -HUGE_VALL, respectively.  

ERRORS

See math_error(7) for information on how to determine whether an error has occurred when calling these functions.

The following errors can occur:

Range error, overflow
errnois set to ERANGE(but see BUGS). An overflow floating-point exception (FE_OVERFLOW) is raised.
 

ATTRIBUTES

For an explanation of the terms used in this section, see attributes(7).
InterfaceAttributeValue
expm1(), expm1f(), expm1l() Thread safetyMT-Safe
 

CONFORMING TO

C99, POSIX.1-2001, POSIX.1-2008.  

BUGS

For some large negative xvalues (where the function result approaches -1), expm1() raises a bogus underflow floating-point exception.

For some large positive xvalues, expm1() raises a bogus invalid floating-point exception in addition to the expected overflow exception, and returns a NaN instead of positive infinity.

Before version 2.11, the glibc implementation did not set errnoto ERANGEwhen a range error occurred.  

SEE ALSO

exp(3), log(3), log1p(3)


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
ERRORS
ATTRIBUTES
CONFORMING TO
BUGS
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 16:30:18 GMT, October 09, 2016 Click Here!