xref: /dragonfly/contrib/openbsd_libm/man/cpow.3 (revision 0ca59c34)
1.\"	$OpenBSD: cpow.3,v 1.3 2013/06/05 03:40:26 tedu Exp $
2.\"
3.\" Copyright (c) 2011 Martynas Venckus <martynas@openbsd.org>
4.\"
5.\" Permission to use, copy, modify, and distribute this software for any
6.\" purpose with or without fee is hereby granted, provided that the above
7.\" copyright notice and this permission notice appear in all copies.
8.\"
9.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16.\"
17.Dd $Mdocdate: June 5 2013 $
18.Dt CPOW 3
19.Os
20.Sh NAME
21.Nm cpow ,
22.Nm cpowf ,
23.Nm cpowl
24.Nd complex power functions
25.Sh SYNOPSIS
26.In complex.h
27.Ft double complex
28.Fn cpow "double complex x" "double complex z"
29.Ft float complex
30.Fn cpowf "float complex x" "float complex z"
31.Ft long double complex
32.Fn cpowl "long double complex x" "long double complex z"
33.Sh DESCRIPTION
34The
35.Fn cpow ,
36.Fn cpowf
37and
38.Fn cpowl
39functions compute the complex number
40.Fa x
41raised to the complex power
42.Fa z ,
43with a branch cut along the negative real axis for the first argument.
44.Sh RETURN VALUES
45The
46.Fn cpow ,
47.Fn cpowf
48and
49.Fn cpowl
50functions return the complex number
51.Fa x
52raised to the complex power
53.Fa z .
54.Sh SEE ALSO
55.Xr cexp 3 ,
56.Xr clog 3
57.Sh STANDARDS
58The
59.Fn cpow ,
60.Fn cpowf
61and
62.Fn cpowl
63functions conform to
64.St -isoC-99 .
65