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 2021-03-22 "" "Linux Programmer's Manual"
   8 .SH NAME
   9 cimag, cimagf, cimagl \- get imaginary part of a complex number
  10 .SH SYNOPSIS
  11 .nf
  12 .B #include <complex.h>
  13 .PP
  14 .BI "double cimag(double complex " z ");"
  15 .BI "float cimagf(float complex " z ");"
  16 .BI "long double cimagl(long double complex " z ");"
  17 .PP
  18 Link with \fI\-lm\fP.
  19 .fi
  20 .SH DESCRIPTION
  21 These functions return the imaginary part of the complex number
  22 .IR z .
  23 .PP
  24 One has:
  25 .PP
  26 .nf
  27     z = creal(z) + I * cimag(z)
  28 .fi
  29 .SH VERSIONS
  30 These functions first appeared in glibc in version 2.1.
  31 .SH ATTRIBUTES
  32 For an explanation of the terms used in this section, see
  33 .BR attributes (7).
  34 .ad l
  35 .nh
  36 .TS
  37 allbox;
  38 lbx lb lb
  39 l l l.
  40 Interface       Attribute       Value
  41 T{
  42 .BR cimag (),
  43 .BR cimagf (),
  44 .BR cimagl ()
  45 T}      Thread safety   MT-Safe
  46 .TE
  47 .hy
  48 .ad
  49 .sp 1
  50 .SH CONFORMING TO
  51 C99, POSIX.1-2001, POSIX.1-2008.
  52 .SH NOTES
  53 gcc also supports __imag__.
  54 That is a GNU extension.
  55 .SH SEE ALSO
  56 .BR cabs (3),
  57 .BR creal (3),
  58 .BR complex (7)