fn pow(comptime T: type, x: T, y: T) T

Returns x raised to the power of y (x^y).

Special Cases:

  • pow(x, +-0) = 1 for any x
  • pow(1, y) = 1 for any y
  • pow(x, 1) = x for any x
  • pow(nan, y) = nan
  • pow(x, nan) = nan
  • pow(+-0, y) = +-inf for y an odd integer < 0
  • pow(+-0, -inf) = +inf
  • pow(+-0, +inf) = +0
  • pow(+-0, y) = +inf for finite y < 0 and not an odd integer
  • pow(+-0, y) = +-0 for y an odd integer > 0
  • pow(+-0, y) = +0 for finite y > 0 and not an odd integer
  • pow(-1, +-inf) = 1
  • pow(x, +inf) = +inf for |x| > 1
  • pow(x, -inf) = +0 for |x| > 1
  • pow(x, +inf) = +0 for |x| < 1
  • pow(x, -inf) = +inf for |x| < 1
  • pow(+inf, y) = +inf for y > 0
  • pow(+inf, y) = +0 for y < 0
  • pow(-inf, y) = pow(-0, -y)
  • pow(x, y) = nan for finite x < 0 and finite non-integer y

Parameters

T: type,
x: T,
y: T,