lib/libm/complex/cacos.3

   1 .\" $NetBSD$
   2 .\" Copyright (c) 2001-2003 The Open Group, All Rights Reserved
   3 .TH "CACOS" 3P 2003 "IEEE/The Open Group" "POSIX Programmer's Manual"
   4 .\" cacos
   5 .SH NAME
   6 cacos, cacosf \- complex arc cosine functions
   7 .SH SYNOPSIS
   8 .LP
   9 \fB#include <complex.h>
  10 .br
  11 .sp
  12 double complex cacos(double complex\fP \fIz\fP\fB);
  13 .br
  14 float complex cacosf(float complex\fP \fIz\fP\fB);
  15 .br
  16 \fP
  17 .SH DESCRIPTION
  18 .LP
  19 These functions compute the complex arc cosine of \fIz\fP, with
  20 branch cuts outside the interval [-1,\ +1] along the
  21 real axis.
  22 .SH RETURN VALUE
  23 .LP
  24 These functions return the complex arc cosine value, in the
  25 range of a strip mathematically unbounded along the imaginary
  26 axis and in the interval [0,\ pi] along the real axis.
  27 .SH ERRORS
  28 .LP
  29 No errors are defined.
  30 .LP
  31 \fIThe following sections are informative.\fP
  32 .SH EXAMPLES
  33 .LP
  34 None.
  35 .SH APPLICATION USAGE
  36 .LP
  37 None.
  38 .SH RATIONALE
  39 .LP
  40 None.
  41 .SH FUTURE DIRECTIONS
  42 .LP
  43 None.
  44 .SH SEE ALSO
  45 .LP
  46 \fIccos\fP(), the Base Definitions volume of IEEE\ Std\ 1003.1-2001,
  47 \fI<complex.h>\fP
  48 .SH COPYRIGHT
  49 Portions of this text are reprinted and reproduced in electronic form
  50 from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
  51 -- Portable Operating System Interface (POSIX), The Open Group Base
  52 Specifications Issue 6, Copyright (C) 2001-2003 by the Institute of
  53 Electrical and Electronics Engineers, Inc and The Open Group. In the
  54 event of any discrepancy between this version and the original IEEE and
  55 The Open Group Standard, the original IEEE and The Open Group Standard
  56 is the referee document. The original Standard can be obtained online at
  57 http://www.opengroup.org/unix/online.html .