Compartilhar via


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.

Valor retornado

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 _Dcomplex valor e retorna um double 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 alfabética de função
norm, normf, norml
creal, crealf, creall
cproj, cprojf, cprojl
conj, conjf, conjl
cimag, cimagf, cimagl
cabs, cabsf, cabsl