man3/cimag.3

   1 .\" Copyright 2002 Walter Harms (walter.harms@informatik.uni-oldenburg.de)
   2 .\"
   3 .\" SPDX-License-Identifier: GPL-1.0-or-later
   4 .\"
   5 .TH CIMAG 3 2021-03-22 "Linux man-pages (unreleased)"
   6 .SH NAME
   7 cimag, cimagf, cimagl \- get imaginary part of a complex number
   8 .SH LIBRARY
   9 Math library
  10 .RI ( libm ", " \-lm )
  11 .SH SYNOPSIS
  12 .nf
  13 .B #include <complex.h>
  14 .PP
  15 .BI "double cimag(double complex " z );
  16 .BI "float cimagf(float complex " z );
  17 .BI "long double cimagl(long double complex " z );
  18 .fi
  19 .SH DESCRIPTION
  20 These functions return the imaginary part of the complex number
  21 .IR z .
  22 .PP
  23 One has:
  24 .PP
  25 .in +4n
  26 .EX
  27 z = creal(z) + I * cimag(z)
  28 .EE
  29 .in
  30 .SH VERSIONS
  31 These functions first appeared in glibc in version 2.1.
  32 .SH ATTRIBUTES
  33 For an explanation of the terms used in this section, see
  34 .BR attributes (7).
  35 .ad l
  36 .nh
  37 .TS
  38 allbox;
  39 lbx lb lb
  40 l l l.
  41 Interface       Attribute       Value
  42 T{
  43 .BR cimag (),
  44 .BR cimagf (),
  45 .BR cimagl ()
  46 T}      Thread safety   MT-Safe
  47 .TE
  48 .hy
  49 .ad
  50 .sp 1
  51 .SH STANDARDS
  52 C99, POSIX.1-2001, POSIX.1-2008.
  53 .SH NOTES
  54 gcc also supports __imag__.
  55 That is a GNU extension.
  56 .SH SEE ALSO
  57 .BR cabs (3),
  58 .BR creal (3),
  59 .BR complex (7)