]> git.ipfire.org Git - thirdparty/man-pages.git/blobdiff - man3/csqrt.3
err.3: EXAMPLES: use EXIT_FAILURE rather than 1 as exit status
[thirdparty/man-pages.git] / man3 / csqrt.3
index eae71af3479924a9d86fa325288b31948cc292fc..4baa0f826260f1eba7056205ab344b5758d706de 100644 (file)
@@ -1,29 +1,49 @@
 .\" Copyright 2002 Walter Harms (walter.harms@informatik.uni-oldenburg.de)
+.\"
+.\" %%%LICENSE_START(GPL_NOVERSION_ONELINE)
 .\" Distributed under GPL
+.\" %%%LICENSE_END
 .\"
-.TH CSQRT 3 2002-07-28 "" "complex math routines"
+.TH CSQRT 3 2017-09-15 "" "Linux Programmer's Manual"
 .SH NAME
 csqrt, csqrtf, csqrtl \- complex square root
 .SH SYNOPSIS
 .B #include <complex.h>
-.sp
+.PP
 .BI "double complex csqrt(double complex " z ");"
 .br
 .BI "float complex csqrtf(float complex " z ");"
 .br
 .BI "long double complex csqrtl(long double complex " z ");"
-.sp
-Link with \-lm.
+.PP
+Link with \fI\-lm\fP.
 .SH DESCRIPTION
-Calculate the square root of a given complex number,
-with nonnegative real part, and
+These functions calculate the complex square root of
+.IR z ,
 with a branch cut along the negative real axis.
-(That means that csqrt(-1+eps*I) will be close to I while
-csqrt(-1-eps*I) will be close to -I, if eps is a small positive
+(That means that \fIcsqrt(\-1+eps*I)\fP will be close to I while
+\fIcsqrt(\-1\-eps*I)\fP will be close to \-I, \fIif eps\fP is a small positive
 real number.)
-.SH "CONFORMING TO"
-C99
-.SH "SEE ALSO"
+.SH VERSIONS
+These functions first appeared in glibc in version 2.1.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbw27 lb lb
+l l l.
+Interface      Attribute       Value
+T{
+.BR csqrt (),
+.BR csqrtf (),
+.BR csqrtl ()
+T}     Thread safety   MT-Safe
+.TE
+.sp 1
+.SH CONFORMING TO
+C99, POSIX.1-2001, POSIX.1-2008.
+.SH SEE ALSO
 .BR cabs (3),
 .BR cexp (3),
-.BR complex (5)
+.BR complex (7)