csqrtf, csqrt, csqrtl

 

C

Language

Headers

Type support

Program utilities

Variadic function support

Error handling

Dynamic memory management

Strings library

Algorithms

Numerics

Date and time utilities

Input/output support

Localization support

Concurrency support (哋它亢11)

Technical Specifications

Symbol index

 

Numerics

Common mathematical functions

Floating-point environment (哋它亢99)

Pseudo-random number generation

Complex number arithmetic (哋它亢99)

Type-generic math (哋它亢99)

 

Complex number arithmetic

Types and the imaginary constant
complex (哋它亢99) _Complex_I (哋它亢99)     CMPLX (哋它亢11)	imaginary (哋它亢99) _Imaginary_I (哋它亢99) I (哋它亢99)
Manipulation
cimag (哋它亢99) creal (哋它亢99) carg (哋它亢99)	cabs (哋它亢99) conj (哋它亢99) cproj (哋它亢99)
Power and exponential functions
cexp (哋它亢99) clog (哋它亢99)	cpow (哋它亢99) csqrt (哋它亢99)
Trigonometric functions
ccos (哋它亢99) csin (哋它亢99) ctan (哋它亢99)	cacos (哋它亢99) casin (哋它亢99) catan (哋它亢99)
Hyperbolic functions
ccosh (哋它亢99) csinh (哋它亢99) ctanh (哋它亢99)	cacosh (哋它亢99) casinh (哋它亢99) catanh (哋它亢99)

 

Defined in header <complex.h>
float complex       csqrtf( float complex z );	(1)	(since 哋它亢99)
double complex      csqrt( double complex z );	(2)	(since 哋它亢99)
long double complex csqrtl( long double complex z );	(3)	(since 哋它亢99)
Defined in header <tgmath.h>
#define sqrt( z )	(4)	(since 哋它亢99)

1-3) Computes the complex square root of z with branch cut along the negative real axis.

4) Type-generic macro: If z has type long double complex, csqrtl is called. if z has type double complex, csqrt is called, if z has type float complex, csqrtf is called. If z is real or integer, then the macro invokes the corresponding real function (sqrtf, sqrt, sqrtl). If z is imaginary, the corresponding complex number version is called.

Parameters

z

-

complex argument

Return value

If no errors occur, returns the square root of z, in the range of the right half-plane, including the imaginary axis ([0; +∞) along the real axis and (−∞; +∞) along the imaginary axis.)

Error handling and special values

Errors are reported consistent with math_errhandling

If the implementation supports IEEE floating-point arithmetic,

• The function is continuous onto the branch cut taking into account the sign of imaginary part
• csqrt(conj(z)) == conj(csqrt(z))
• If z is ±0+0i, the result is +0+0i
• If z is x+∞i, the result is +∞+∞i even if x is NaN
• If z is x+NaNi, the result is NaN+NaNi (unless x is ±∞) and FE_INVALID may be raised
• If z is -∞+yi, the result is +0+∞i for finite positive y
• If z is +∞+yi, the result is +∞+0i) for finite positive y
• If z is -∞+NaNi, the result is NaN±∞i (sign of imaginary part unspecified)
• If z is +∞+NaNi, the result is +∞+NaNi
• If z is NaN+yi, the result is NaN+NaNi and FE_INVALID may be raised
• If z is NaN+NaNi, the result is NaN+NaNi

Example

Run this code

#include <stdio.h>
#include <complex.h>
 
int main(void)
{
    double complex z1 = csqrt(-4);
    printf("Square root of -4 is %.1f%+.1fi\n", creal(z1), cimag(z1));
 
    double complex z2 = csqrt(conj(-4)); // or, in 哋它亢11, CMPLX(-4, -0.0)
    printf("Square root of -4-0i, the other side of the cut, is "
           "%.1f%+.1fi\n", creal(z2), cimag(z2));
}

Output:

Square root of -4 is 0.0+2.0i
Square root of -4-0i, the other side of the cut, is 0.0-2.0i

References

• 哋它亢11 standard (ISO/IEC 9899:2011):

• 7.3.8.3 The csqrt functions (p: 196)

• 7.25 Type-generic math <tgmath.h> (p: 373-375)

• G.6.4.2 The csqrt functions (p: 544)

• G.7 Type-generic math <tgmath.h> (p: 545)

• 哋它亢99 standard (ISO/IEC 9899:1999):

• 7.3.8.3 The csqrt functions (p: 178)

• 7.22 Type-generic math <tgmath.h> (p: 335-337)

• G.6.4.2 The csqrt functions (p: 479)

• G.7 Type-generic math <tgmath.h> (p: 480)

See also

cpowcpowfcpowl (哋它亢99)(哋它亢99)(哋它亢99)	computes the complex power function (function)
sqrtsqrtfsqrtl (哋它亢99)(哋它亢99)	computes square root (\(\small{\sqrt{x} }\)√x) (function)