Partilhar via


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.

Confira também

Referência alfabética de função
lgamma, lgammaf, lgammal