man3/csqrt.3

   1 .\" Copyright 2002 Walter Harms (walter.harms@informatik.uni-oldenburg.de)
   2 .\"
   3 .\" %%%LICENSE_START(GPL_NOVERSION_ONELINE)
   4 .\" Distributed under GPL
   5 .\" %%%LICENSE_END
   6 .\"
   7 .TH CSQRT 3 2021-03-22 "" "Linux Programmer's Manual"
   8 .SH NAME
   9 csqrt, csqrtf, csqrtl \- complex square root
  10 .SH SYNOPSIS
  11 .nf
  12 .B #include <complex.h>
  13 .PP
  14 .BI "double complex csqrt(double complex " z ");"
  15 .BI "float complex csqrtf(float complex " z ");"
  16 .BI "long double complex csqrtl(long double complex " z ");"
  17 .PP
  18 Link with \fI\-lm\fP.
  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 first appeared in glibc in version 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 CONFORMING TO
  49 C99, POSIX.1-2001, POSIX.1-2008.
  50 .SH SEE ALSO
  51 .BR cabs (3),
  52 .BR cexp (3),
  53 .BR complex (7)