diff options
author | das <das@FreeBSD.org> | 2007-12-12 23:43:51 +0000 |
---|---|---|
committer | das <das@FreeBSD.org> | 2007-12-12 23:43:51 +0000 |
commit | b9a043d44cc426b5fe354db2cf705e59e5b3a867 (patch) | |
tree | 79fcbb5dd5acb03b187bc82dfc2af59cd0cc2e55 /lib/msun/man | |
parent | facc60167bbbf9e19b3968e7e98afe0f6af4231a (diff) | |
download | FreeBSD-src-b9a043d44cc426b5fe354db2cf705e59e5b3a867.zip FreeBSD-src-b9a043d44cc426b5fe354db2cf705e59e5b3a867.tar.gz |
Implement carg(3) and cargf(3).
Rotting in an old src tree since: March 2005
Diffstat (limited to 'lib/msun/man')
-rw-r--r-- | lib/msun/man/atan2.3 | 44 | ||||
-rw-r--r-- | lib/msun/man/hypot.3 | 3 |
2 files changed, 41 insertions, 6 deletions
diff --git a/lib/msun/man/atan2.3 b/lib/msun/man/atan2.3 index 6619297..eecfcde 100644 --- a/lib/msun/man/atan2.3 +++ b/lib/msun/man/atan2.3 @@ -28,13 +28,15 @@ .\" from: @(#)atan2.3 5.1 (Berkeley) 5/2/91 .\" $FreeBSD$ .\" -.Dd January 14, 2005 +.Dd December 12, 2007 .Dt ATAN2 3 .Os .Sh NAME .Nm atan2 , -.Nm atan2f -.Nd arc tangent functions of two variables +.Nm atan2f , +.Nm carg , +.Nm cargf +.Nd arc tangent and complex phase angle functions .Sh LIBRARY .Lb libm .Sh SYNOPSIS @@ -43,6 +45,10 @@ .Fn atan2 "double y" "double x" .Ft float .Fn atan2f "float y" "float x" +.Ft double +.Fn carg "double complex z" +.Ft float +.Fn cargf "float complex z" .Sh DESCRIPTION The .Fn atan2 @@ -52,6 +58,29 @@ functions compute the principal value of the arc tangent of .Fa y/ Ns Ar x , using the signs of both arguments to determine the quadrant of the return value. +.ie '\*[.T]'utf8' \{\ +. ds Th \[*h] +.\} +.el \{\ +. ds Th theta +.\} +.Pp +The +.Fn carg +and +.Fn cargf +functions compute the complex argument (or phase angle) of +.Fa z . +The complex argument is the number \*(Th such that +.Li z = r * e^(I * \*(Th) , +where +.Li r = cabs(z) . +The call +.Li carg(z) +is equivalent to +.Li atan2(cimag(z), creal(z)) , +and similarly for +.Fn cargf . .Sh RETURN VALUES The .Fn atan2 @@ -169,6 +198,7 @@ r := \(sr(x\(**x+y\(**y);\0\0if r = 0 then x := copysign(1,x); .Xr acos 3 , .Xr asin 3 , .Xr atan 3 , +.Xr cabs 3 , .Xr cos 3 , .Xr cosh 3 , .Xr math 3 , @@ -178,6 +208,10 @@ r := \(sr(x\(**x+y\(**y);\0\0if r = 0 then x := copysign(1,x); .Xr tanh 3 .Sh STANDARDS The -.Fn atan2 -function conforms to +.Fn atan2 , +.Fn atan2f , +.Fn carg , +and +.Fn cargf +functions conform to .St -isoC . diff --git a/lib/msun/man/hypot.3 b/lib/msun/man/hypot.3 index 2b353f7..978b390 100644 --- a/lib/msun/man/hypot.3 +++ b/lib/msun/man/hypot.3 @@ -28,7 +28,7 @@ .\" from: @(#)hypot.3 6.7 (Berkeley) 5/6/91 .\" $FreeBSD$ .\" -.Dd January 14, 2005 +.Dd December 12, 2007 .Dt HYPOT 3 .Os .Sh NAME @@ -118,6 +118,7 @@ the disappear when it turns out to be irrelevant, as it does in .Fn hypot "\*(If" "\*(Na" . .Sh SEE ALSO +.Xr carg 3 , .Xr math 3 , .Xr sqrt 3 .Sh HISTORY |