132daf9997b25b57f5e218f995d70fb10ec4c801
[dragonfly.git] / lib / libm / complex / csqrt.3
1 .\" $NetBSD: csqrt.3,v 1.1 2008/02/20 09:55:38 drochner Exp $
2 .\" Copyright (c) 2001-2003 The Open Group, All Rights Reserved
3 .TH "CSQRT" 3P 2003 "IEEE/The Open Group" "POSIX Programmer's Manual"
4 .\" csqrt
5 .SH NAME
6 csqrt, csqrtf \- complex square root functions
7 .SH SYNOPSIS
8 .LP
9 \fB#include <complex.h>
10 .br
11 .sp
12 double complex csqrt(double complex\fP \fIz\fP\fB);
13 .br
14 float complex csqrtf(float complex\fP \fIz\fP\fB);
15 .br
16 \fP
17 .SH DESCRIPTION
18 .LP
19 These functions compute the complex square root of \fIz\fP,
20 with a branch cut along the negative real axis.
21 .SH RETURN VALUE
22 .LP
23 These functions return the complex square root value, in the
24 range of the right half-plane (including the imaginary
25 axis).
26 .SH ERRORS
27 .LP
28 No errors are defined.
29 .LP
30 \fIThe following sections are informative.\fP
31 .SH EXAMPLES
32 .LP
33 None.
34 .SH APPLICATION USAGE
35 .LP
36 None.
37 .SH RATIONALE
38 .LP
39 None.
40 .SH FUTURE DIRECTIONS
41 .LP
42 None.
43 .SH SEE ALSO
44 .LP
45 \fIcabs\fP(), \fIcpow\fP(), the Base Definitions volume of
46 IEEE\ Std\ 1003.1-2001, \fI<complex.h>\fP
47 .SH COPYRIGHT
48 Portions of this text are reprinted and reproduced in electronic form
49 from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
50 -- Portable Operating System Interface (POSIX), The Open Group Base
51 Specifications Issue 6, Copyright (C) 2001-2003 by the Institute of
52 Electrical and Electronics Engineers, Inc and The Open Group. In the
53 event of any discrepancy between this version and the original IEEE and
54 The Open Group Standard, the original IEEE and The Open Group Standard
55 is the referee document. The original Standard can be obtained online at
56 http://www.opengroup.org/unix/online.html .