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 2013-06-21 "" "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 ATTRIBUTES
  34 .SS Multithreading (see pthreads(7))
  35 The
  36 .BR cimag (),
  37 .BR cimagf (),
  38 and
  39 .BR cimagl ()
  40 functions are thread-safe.
  41 .SH CONFORMING TO
  42 C99.
  43 .SH NOTES
  44 gcc also supports __imag__.
  45 That is a GNU extension.
  46 .SH SEE ALSO
  47 .BR cabs (3),
  48 .BR creal (3),
  49 .BR complex (7)
  50 .SH COLOPHON
  51 This page is part of release 3.67 of the Linux
  52 .I man-pages
  53 project.
  54 A description of the project,
  55 information about reporting bugs,
  56 and the latest version of this page,
  57 can be found at
  58 \%http://www.kernel.org/doc/man\-pages/.