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