tgamma, tgammaf, tgammal
Determina a função gama do valor especificado.
Sintaxe
double tgamma(
double x
);
float tgammaf(
float x
);
long double tgammal(
long double x
);
#define tgamma(X) // Requires C11 or higher
float tgamma(
float x
); //C++ only
long double tgamma(
long double x
); //C++ only
Parâmetros
x
O valor do qual o gama será encontrado.
Valor retornado
Se tiver êxito, retornará o gama de x.
Poderá ocorrer um erro de intervalo se a magnitude de x for muito grande ou muito pequena para o tipo de dados. Um erro de domínio ou erro de intervalo pode ocorrer se x<= 0.
| Problema | Return |
|---|---|
x = ±0 |
±INFINITY |
x = inteiro negativo |
NaN |
x = -INFINITY |
NaN |
x = +INFINITY |
+INFINITY |
x = NaN |
NaN |
| erro de domínio | NaN |
| erro de polo | ±HUGE_VAL, ±HUGE_VALF ou ±HUGE_VALL |
| erro de intervalo de estouro | ±HUGE_VAL, ±HUGE_VALF ou ±HUGE_VALL |
| erro de intervalo de estouro negativo | o valor correto, após o arredondamento. |
Os erros são relatados conforme especificado em _matherr.
Comentários
Como C++ permite sobrecargas, é possível chamar sobrecargas de tgamma 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, tgamma sempre recebe e retorna um double.
Se você usa a macro <tgmath.h>tgamma(), 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 natural, essa função retornará o 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++ |
|---|---|---|
tgamma, tgammaf, tgammal |
<math.h> | <cmath> |
Macro tgamma |
<tgmath.h> |
Para obter informações sobre compatibilidade, consulte Compatibilidade.