carg, cargf, cargl

检索沿负实轴分支切割的复数的参数。

语法

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

参数

z
一个复数。

返回值

z 的自变量（也称为相位）。 结果位于 [-π, +π] 的间隔内。

备注

由于 C++ 允许重载，因此可以调用采用 _Fcomplex 或 _Lcomplex 值的 carg 的重载，并返回 float 或 long double 值。 在 C 程序中，除非使用 <tgmath.h> 宏调用此函数，否则 carg 始终采用 _Dcomplex 值并返回 double 值。

如果使用 <tgmath.h>carg() 宏，则参数的类型将决定选择哪个版本的函数。 有关详细信息，请参阅泛型类型数学。

要求

例程	C 标头	C++ 标头
carg, cargf, cargl	<complex.h>	<ccomplex>
carg 宏	<tgmath.h>

有关兼容性的详细信息，请参阅 兼容性。

另请参阅

按字母顺序显示的函数参考
norm、normf、norml
creal、crealf、creall
cproj、cprojf、cprojl
conj、conjf、conjl
cimag、cimagf、cimagl
cabs、cabsf、cabsl