Matemática do tipo genérico

Para ISO C Standard 11 (C11) e posterior, o cabeçalho <tgmath.h>, além de incluir <math.h> e <complex.h>, fornece macros que invocam uma função matemática correspondente com base nos tipos de parâmetros .

As funções matemáticas da biblioteca de runtime C vêm em variantes reais e complexas. Cada variante vem em três tipos, dependendo do tipo de argumento: float, double e long double. Como C não dá suporte para sobrecarga como C++, cada variante tem um nome diferente. Por exemplo, para obter o valor absoluto de um valor de ponto flutuante real, você chamará fabsf, fabs ou fabsl dependendo se estiver passando um valor float, double ou long double, respectivamente. Para obter o valor absoluto complexo, você chamará um dos cabsf, cabs ou cabsl dependendo se estiver passando um valor complexo float, double e long double, respectivamente. Se os argumentos não corresponderem a nenhum dos tipos mencionados acima, a função será escolhida como se os argumentos fossem duplos.

<tgmath.h> contém macros que simplificam a seleção da função matemática correta a ser chamada. As macros examinam o tipo que são passadas e, em seguida,chamam a função correta. Por exemplo, a macro sqrt associa sqrt(9.9f) a sqrtf(), mas isso associa sqrt(9.9) a sqrt(). Se pelo menos um argumento de macro para um parâmetro genérico for complexo, a macro será vinculada a uma função complexa, caso contrário, ele invocará uma função real.

As macros genéricas de tipo em <tgmath.h> permitem gravar código mais portátil porque não é necessário gerenciar a conversão ou selecionar os nomes de funções diferentes dependendo do tipo de argumento.

Essas macros estão no próprio cabeçalho para que os programas gravados usando o cabeçalho <math.h> não sejam interrompidos. Desse modo, double x = sin(42); se comportará como sempre quando você incluir <matemática.h>. Mesmo assim, espera-se que a maioria dos programas C existentes não sejam afetados quando o <tgmath.h> cabeçalho for incluído, em vez de <math.h> ou <complex.h>.

A tabela a seguir lista as macros que estão disponíveis em <tgmath.h> e para o que se expandem. modf não está incluída nesta tabela porque não possui uma macro genérica de tipo correspondente, já que não está claro como torná-la seguro sem complicar a resolução do tipo.

Macro Real
float
Real
double
Real
long double
Complexa
float
Complexa
double
Complexa
long double
acos acosf acos acosl cacosf cacos cacosl
acosh acoshf acosh acoshl cacoshf cacosh cacoshl
asin asinf asin asinl casinf casin casinl
asinh asinhf asinh asinhl casinhf casinh casinhl
atan atanf atan atanl catanf catan catanl
atanh atanhf atanh atanhl catanhf catanh catanhl
cos cosf cos cosl ccosf ccos ccosl
cosh coshf cosh coshl ccoshf ccosh ccoshl
exp expf exp expl cexpf cexp cexpl
fabs fabsf fabs fabsl cabsf cabs cabsl
log logf log logl clogf clog clogl
pow powf pow powl cpowf cpow cpowl
sin sinf sin sinl csinf csin csinl
sinh sinhf sinh sinhl csinhf csinh csinhl
sqrt sqrtf sqrt sqrtl csqrtf csqrt csqrtl
tan tanf tan tanl ctanf ctan ctanl
tanh tanhf tanh tanhl ctanhf ctanh ctanhl
atan2 atan2f atan2 atan2l - - -
cbrt cbrtf cbrt cbrtl - - -
ceil ceilf ceil ceill - - -
copysign copysignf copysign copysignl - - -
erf erff erf erfl - - -
erfc erfcf erfc erfcl - - -
exp2 exp2f exp2 exp2l - - -
expm1 expm1f expm1 expm1l - - -
fdim fdimf fdim fdiml - - -
floor floorf floor floorl - - -
fma fmaf fma fmal - - -
fmax fmaxf fmax fmaxl - - -
fmin fminf fmin fminl - - -
fmod fmodf fmod fmodl - - -
frexp frexpf frexp frexpl - - -
hypot hypotf hypot hypotl - - -
ilogb ilogbf ilogb ilogbl - - -
ldexp ldexpf ldexp ldexpl - - -
lgamma lgammaf lgamma lgammal - - -
llrint llrintf llrint llrintl - - -
llround llroundf llround llroundl - - -
log10 log10f log10 log10l - - -
log1p log1pf log1p log1pl - - -
log2 log2f log2 log2l - - -
logb logbf logb logbl - - -
lrint lrintf lrint lrintl - - -
lround lroundf lround lroundl - - -
nearbyint nearbyintf nearbyint nearbyintl - - -
nextafter nextafterf nextafter nextafterl - - -
nexttoward nexttowardf nexttoward nexttowardl - - -
remainder remainderf remainder remainderl - - -
remquo remquof remquo remquol - - -
rint rintf rint rintl - - -
round roundf round roundl - - -
scalbln scalblnf scalbln scalblnl - - -
scalbn scalbnf scalbn scalbnl - - -
tgamma tgammaf tgamma tgammal - - -
trunc truncf trunc truncl - - -
carg - - - cargf carg cargl
conj - - - conjf conj conjl
creal - - - crealf creal creall
cimag - - - cimagf cimag cimagl
cproj - - - cprojf cproj cprojl

Requisitos

Compilar com /std:c11.

O SDK do Windows 10.0.20348.0 (versão 2104) ou posterior. Consulte o SDK do Windows para baixar o SDK mais recente. Para obter instruções sobre como instalar e usar o SDK para desenvolvimento C11 e C17, consulte Instalar o suporte C11 e C17 no Visual Studio.

Confira também

Referência da biblioteca de runtime C