lib/msun/man/cpow.3

   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
  33 The
  34 .Fn cpow ,
  35 .Fn cpowf
  36 and
  37 .Fn cpowl
  38 functions compute the complex number
  39 .Fa x
  40 raised to the complex power
  41 .Fa z ,
  42 with a branch cut along the negative real axis for the first argument.
  43 .Sh RETURN VALUES
  44 The
  45 .Fn cpow ,
  46 .Fn cpowf
  47 and
  48 .Fn cpowl
  49 functions return the complex number
  50 .Fa x
  51 raised to the complex power
  52 .Fa z .
  53 .Sh SEE ALSO
  54 .Xr cexp 3 ,
  55 .Xr clog 3
  56 .Sh STANDARDS
  57 The
  58 .Fn cpow ,
  59 .Fn cpowf
  60 and
  61 .Fn cpowl
  62 functions conform to
  63 .St -isoC-99 .