man3/csqrt.3

   1 '\" t
   2 .\" Copyright 2002 Walter Harms (walter.harms@informatik.uni-oldenburg.de)
   3 .\"
   4 .\" SPDX-License-Identifier: GPL-1.0-or-later
   5 .\"
   6 .TH csqrt 3 (date) "Linux man-pages (unreleased)"
   7 .SH NAME
   8 csqrt, csqrtf, csqrtl \- complex square root
   9 .SH LIBRARY
  10 Math library
  11 .RI ( libm ", " \-lm )
  12 .SH SYNOPSIS
  13 .nf
  14 .B #include <complex.h>
  15 .PP
  16 .BI "double complex csqrt(double complex " z );
  17 .BI "float complex csqrtf(float complex " z );
  18 .BI "long double complex csqrtl(long double complex " z );
  19 .fi
  20 .SH DESCRIPTION
  21 These functions calculate the complex square root of
  22 .IR z ,
  23 with a branch cut along the negative real axis.
  24 (That means that \fIcsqrt(\-1+eps*I)\fP will be close to I while
  25 \fIcsqrt(\-1\-eps*I)\fP will be close to \-I, \fIif eps\fP is a small positive
  26 real number.)
  27 .SH VERSIONS
  28 These functions were added in glibc 2.1.
  29 .SH ATTRIBUTES
  30 For an explanation of the terms used in this section, see
  31 .BR attributes (7).
  32 .ad l
  33 .nh
  34 .TS
  35 allbox;
  36 lbx lb lb
  37 l l l.
  38 Interface       Attribute       Value
  39 T{
  40 .BR csqrt (),
  41 .BR csqrtf (),
  42 .BR csqrtl ()
  43 T}      Thread safety   MT-Safe
  44 .TE
  45 .hy
  46 .ad
  47 .sp 1
  48 .SH STANDARDS
  49 C99, POSIX.1-2001, POSIX.1-2008.
  50 .SH SEE ALSO
  51 .BR cabs (3),
  52 .BR cexp (3),
  53 .BR complex (7)