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 .P
  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 ATTRIBUTES
  28 For an explanation of the terms used in this section, see
  29 .BR attributes (7).
  30 .TS
  31 allbox;
  32 lbx lb lb
  33 l l l.
  34 Interface       Attribute       Value
  35 T{
  36 .na
  37 .nh
  38 .BR csqrt (),
  39 .BR csqrtf (),
  40 .BR csqrtl ()
  41 T}      Thread safety   MT-Safe
  42 .TE
  43 .SH STANDARDS
  44 C11, POSIX.1-2008.
  45 .SH HISTORY
  46 glibc 2.1.
  47 C99, POSIX.1-2001.
  48 .SH SEE ALSO
  49 .BR cabs (3),
  50 .BR cexp (3),
  51 .BR complex (7)