carg, cargf, cargl

Recupera o argumento de um número complexo, com uma ramificação cortada ao longo do eixo real negativo.

Sintaxe

double carg(
   _Dcomplex z
);
float carg(
   _Fcomplex z
);  // C++ only
long double carg(
   _Lcomplex z
);  // C++ only
float cargf(
   _Fcomplex z
);
long double cargl(
   _Lcomplex z
);
#define carg(X) // Requires C11 or higher

Parâmetros

z
Um número complexo.

Retornar valor

O argumento (também conhecido como a fase) de z. O resultado está no intervalo [-π, +π].

Comentários

Como o C++ permite sobrecargas, é possível chamar sobrecargas de carg e que usam valores _Fcomplex ou _Lcomplex e retornam valores float ou long double. Em um programa C, a menos que você esteja usando a <macro tgmath.h> para chamar essa função, carg sempre usa um valor e retorna um double_Dcomplex valor.

Se você usa a macro <tgmath.h>carg(), o tipo do argumento determina qual versão da função será selecionada. Confira Matemática do tipo genérico para obter detalhes.

Requisitos

Rotina	Cabeçalho C	Cabeçalho C++
carg, cargf, cargl	<complex.h>	<ccomplex>
Macro carg	<tgmath.h>

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Confira também

Referência de função alfabética
norm, normf, norml
creal, crealf, creall
cproj, cprojf, cprojl
conj, conjf, conjl
cimag, cimagf, cimagl
cabs, cabsf, cabsl