log1p(3m) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

log1p(3m)

log1p(3M)               Mathematical Library Functions               log1p(3M)

NAME
       log1p, log1pf, log1pl - compute natural logarithm

SYNOPSIS
       c99 [ flag... ] file... -lm [ library... ]
       #include <math.h>

       double log1p(double x);


       float log1pf(float x);


       long double log1pl(long double x);

DESCRIPTION
       These functions compute log(e)(1.0 + x).

RETURN VALUES
       Upon  successful  completion,  these functions return the natural loga‐
       rithm of 1.0 + x.


       If x is −1, a pole error occurs and log1p(), log1pf(), and log1pl() re‐
       turn −HUGE_VAL, −HUGE_VALF, and −HUGE_VALL, respectively.


       For finite values of x that are less than −1, or if x is −Inf, a domain
       error occurs and a NaN is returned.


       If x is NaN, a NaN is returned.


       If x is ±0 or +Inf, x is returned.


       For exceptional cases, matherr(3M) tabulates the values to be  returned
       by log1p() as specified by SVID3 and XPG3.

ERRORS
       These functions will fail if:

       Domain Error    The finite value of x is less than −1, or x is -Inf.

                       If  the integer expression (math_errhandling & MATH_ER‐
                       REXCEPT) is non-zero, the invalid floating-point excep‐
                       tion is raised.

                       The log1p() function sets errno to EDOM if the value of
                       x is less than −1.


       Pole Error      The value of x is −1.

                       If the integer expression (math_errhandling &  MATH_ER‐
                       REXCEPT) is non-zero, the divide-by-zero floating-point
                       exception is raised.


USAGE
       An  application  wanting to check for exceptions should call feclearex‐
       cept(FE_ALL_EXCEPT) before  calling  these  functions.  On  return,  if
       fetestexcept(FE_INVALID | FE_DIVBYZERO | FE_OVERFLOW | FE_UNDERFLOW) is
       non-zero,  an  exception  has been raised. An application should either
       examine the return value or check the floating point exception flags to
       detect exceptions.


       An application can also set errno to 0 before calling log1p().  On  re‐
       turn,  if  errno  is  non-zero, an error has occurred. The log1pf() and
       log1pl() functions do not set errno.

ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:

       tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i)


       ATTRIBUTE TYPEATTRIBUTE VALUE _ Interface StabilityCommitted  _  Avail‐
       abilitysystem/library/math   _   MT-LevelMT-Safe  _  StandardSee  stan‐
       dards(7).


SEE ALSO
       math.h(3HEAD),  feclearexcept(3M),  fetestexcept(3M),  log(3M),   math‐
       err(3M), standards(7), attributes(7)

Solaris 11.4                     27 sept 2016                        log1p(3M)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3