expm1(3)

NOME
expm1, expm1f, expm1l - exponencial menos 1

BIBLIOTECA
Biblioteca matemática (libm, -lm)

SINOPSE
#include <math.h>

double expm1(double x);
float expm1f(float x);
long double expm1l(long double x);

    Requisitos de macro de teste de recursos para o glibc (consulte feature_test_macros(7)):

expm1():
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
        || _XOPEN_SOURCE >= 500
        || /* Desde o glibc 2.19: */ _DEFAULT_SOURCE
        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

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

DESCRIÇÃO
Essas funções retornam um valor equivalente a

    exp(x) - 1

O resultado é calculado de tal forma que é preciso até se o valor de x está próximo de zero, caso em que exp(x) - 1 seria impreciso devido à subtração de dois números quase iguais.

VALOR DE RETORNO
Em caso de sucesso, essas funções retornam exp(x) - 1.

Se x é um NaN, um NaN é retornado.

Se x é +0 (-0), +0 (-0) é retornado.

Se x é infinito positivo, infinito positivo é retornado.

Se x é infinito negativo, -1 é retornado.

Se o resultado é excedido, ocorrerá um erro de intervalo e as funções retornam -HUGE_VAL, -HUGE_VALF ou -HUGE_VALL, respectivamente.

ERROS
Consulte math_error(7) para obter informações sobre como determinar se ocorreu um erro ao chamar essas funções.

Os seguintes erros podem ocorrer:

Range error, overflow
    errno é definido com ERANGE (mas veja BUGS). Uma exceção de ponto flutuante de estouro (FE_OVERFLOW) é levantada.

ATRIBUTOS
Para uma explicação dos termos usados nesta seção, consulte attributes(7).
Interface | Atributo | Valor
expm1(), expm1f(), expm1l() | Thread safety | MT-Safe

PADRÕES
C11, POSIX.1-2008.

HISTÓRICO
C99, POSIX.1-2001. BSD.

BUGS
Antes do glibc 2.17, em certas arquiteturas (por exemplo, x86, mas não x86_64) expm1() gerava uma exceção falsa de ponto flutuante de estouro negativo para alguns valores x negativos grandes (onde o resultado da função se aproxima de -1).

Antes aproximadamente do glibc 2.11, expm1() gerava uma exceção falsa de ponto flutuante inválida, além da exceção de estouro esperada, e retornava um NaN em vez de infinito positivo, para alguns valores x positivos grandes.

Antes do glibc 2.11, a implementação do gblic não define errno com EDOM quando ocorreu um erro de domínio.

VEJA TAMBÉM
exp(3), log(3), log1p(3)

TRADUÇÃO
A tradução para português brasileiro desta página man foi criada por Felipe M Pereira <Felipe.Pereira@ic.unicamp.br>, André Luiz Fassone <lonely_wolf@ig.com.br> e Rafael Fontenelle <rafaelff@gnome.org>.

Esta tradução é uma documentação livre; leia a Licença Pública Geral GNU Versão 3 (https://www.gnu.org/licenses/gpl-3.0.html) ou posterior para as condições de direitos autorais. Nenhuma responsabilidade é aceita.

Se você encontrar algum erro na tradução desta página de manual, envie um e-mail para a lista de discussão de tradutores (debian-l10n-portuguese@lists.debian.org).