man3/cproj.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 CPROJ 3 2021-03-22 "" "Linux Programmer's Manual"
   8 .SH NAME
   9 cproj, cprojf, cprojl \- project into Riemann Sphere
  10 .SH SYNOPSIS
  11 .nf
  12 .B #include <complex.h>
  13 .PP
  14 .BI "double complex cproj(double complex " z ");"
  15 .BI "float complex cprojf(float complex " z ");"
  16 .BI "long double complex cprojl(long double complex " z ");"
  17 .PP
  18 Link with \fI\-lm\fP.
  19 .fi
  20 .SH DESCRIPTION
  21 These functions project a point in the plane onto the surface of a
  22 Riemann Sphere, the one-point compactification of the complex plane.
  23 Each finite point
  24 .I z
  25 projects to
  26 .I z
  27 itself.
  28 Every complex infinite value is projected to a single infinite value,
  29 namely to positive infinity on the real axis.
  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 cproj (),
  44 .BR cprojf (),
  45 .BR cprojl ()
  46 T}      Thread safety   MT-Safe
  47 .TE
  48 .hy
  49 .ad
  50 .sp 1
  51 .SH CONFORMING TO
  52 C99, POSIX.1-2001, POSIX.1-2008.
  53 .SH NOTES
  54 In glibc 2.11 and earlier, the implementation does something different
  55 (a
  56 .I stereographic
  57 projection onto a Riemann Sphere).
  58 .\" http://sources.redhat.com/bugzilla/show_bug.cgi?id=10401
  59 .SH SEE ALSO
  60 .BR cabs (3),
  61 .BR complex (7)