Scroll to navigation

ldexp(3) Library Functions Manual ldexp(3)

NOME

ldexp, ldexpf, ldexpl - multiplica número de ponto flutuante por potência inteira de 2

BIBLIOTECA

Biblioteca matemática (libm, -lm)

SINOPSE

#include <math.h>
double ldexp(double x, int exp);
float ldexpf(float x, int exp);
long double ldexpl(long double x, int exp);

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

ldexpf(), ldexpl():


_ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
|| /* Desde o glibc 2.19: */ _DEFAULT_SOURCE
|| /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

DESCRIÇÃO

As funções retornam o resultado da multiplicação de um número de ponto flutuante x por 2 elevado à potência exp.

VALOR DE RETORNO

On success, these functions return x * (2^exp).

Se exp é zero, x é retornado.

Se x é um NaN, um NaN é retornado.

Se x é um infinito positivo (infinito negativo), infinito positivo (infinito negativo) é retornado.

Se o resultado for insuficiente, ocorrerá um erro de intervalo e zero será retornado.

Se o resultado estourar, 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:

errno é definido com ERANGE. Uma exceção de ponto flutuante de estouro (FE_OVERFLOW) é levantada.
errno é definido com ERANGE. Uma exceção de ponto flutuante de estouro negativo (FE_UNDERFLOW) é levantada.

ATRIBUTOS

Para uma explicação dos termos usados nesta seção, consulte attributes(7).

Interface Atributo Valor
ldexp(), ldexpf(), ldexpl() Thread safety MT-Safe

PADRÕES

C11, POSIX.1-2008.

HISTÓRICO

C99, POSIX.1-2001.

A variante retornando double também está de acordo com SVr4, 4.3BSD, C89.

VEJA TAMBÉM

frexp(3), modf(3), scalbln(3)

TRADUÇÃO

A tradução para português brasileiro desta página man foi criada por Valter Ferraz Sanches <vfs@ezlinux.cjb.net>, 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 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.

2 maio 2024 Linux man-pages (unreleased)