lgamma, lgammaf, lgammal
Determina o logaritmo natural do valor absoluto da função gama do valor especificado.
Sintaxe
double lgamma( double x );
float lgammaf( float x );
long double lgammal( long double x );
#define lgammal(X) // Requires C11 or higher
float lgamma( float x ); //C++ only
long double lgamma( long double x ); //C++ only
Parâmetros
x
O valor a ser computado.
Valor retornado
Se for bem-sucedido, retorne o logaritmo natural do valor absoluto da função gama de x.
| Problema | Return |
|---|---|
x = NaN |
NaN |
x = ±0 |
+INFINITY |
x= inteiro negativo |
+INFINITY |
| ±INFINITY | +INFINITY |
| erro de polo | +HUGE_VAL, +HUGE_VALF ou +HUGE_VALL |
| erro de intervalo de estouro | ±HUGE_VAL, ±HUGE_VALF ou ±HUGE_VALL |
Os erros são relatados conforme especificado em _matherr.
Comentários
Como C++ permite sobrecargas, é possível chamar sobrecargas de lgamma que usam e retornam tipos float e long double. Em um programa C, a menos que esteja usando a macro <tgmath.h> para chamar essa função, lgamma sempre recebe e retorna um double.
Se você usa a macro <tgmath.h>lgamma(), o tipo do argumento determina qual versão da função será selecionada. Confira Matemática do tipo genérico para obter detalhes.
Se x for um número racional, essa função retornará o logaritmo do fatorial de (x - 1).
Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, confira Estado global no CRT.
Requisitos
| Função | Cabeçalho C | Cabeçalho C++ |
|---|---|---|
lgamma, lgammaf, lgammal |
<math.h> | <cmath> |
Macro lgamma |
<tgmath.h> |
Para obter informações sobre compatibilidade, consulte Compatibilidade.