original/man3/cimag.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 CIMAG 3 2008-08-11 "" "Linux Programmer's Manual"
   8 .SH NAME
   9 cimag, cimagf, cimagl \- get imaginary part of a complex number
  10 .SH SYNOPSIS
  11 .B #include <complex.h>
  12 .sp
  13 .BI "double cimag(double complex " z ");"
  14 .br
  15 .BI "float cimagf(float complex " z ");"
  16 .br
  17 .BI "long double cimagl(long double complex " z ");"
  18 .sp
  19 Link with \fI\-lm\fP.
  20 .SH DESCRIPTION
  21 The
  22 .BR cimag ()
  23 function returns the imaginary part of the complex number
  24 .IR z .
  25 .LP
  26 One has:
  27 .nf
  28
  29     z = creal(z) + I * cimag(z)
  30 .fi
  31 .SH VERSIONS
  32 These functions first appeared in glibc in version 2.1.
  33 .SH CONFORMING TO
  34 C99.
  35 .SH NOTES
  36 gcc also supports __imag__.
  37 That is a GNU extension.
  38 .SH SEE ALSO
  39 .BR cabs (3),
  40 .BR creal (3),
  41 .BR complex (7)