dart:math

Функция pow

Возвращает x в степени exponent.

Если x является целым числом и exponent является неотрицательным целым числом, результат — целое число, в противном случае оба аргумента сначала преобразуются в числа с плавающей точкой двойной точности, и результат — число с плавающей точкой двойной точности.

Для целых чисел степень всегда равна математическому результату x в степени exponent, ограниченному только доступной памятью.

Для чисел с плавающей точкой двойной точности pow(x, y) обрабатывает граничные случаи следующим образом:

• если y равно нулю (0,0 или -0,0), результат всегда равен 1,0.
• если x равно 1,0, результат всегда равен 1,0.
• в противном случае, если x или y — NaN, то результат — NaN.
• если x отрицательно (но не -0,0) и y — конечное нецелое число, результат — NaN.
• если x равно Бесконечности и y отрицательно, результат — 0,0.
• если x равно Бесконечности и y положительно, результат — Бесконечность.
• если x равно 0,0 и y отрицательно, результат — Бесконечность.
• если x равно 0,0 и y положительно, результат — 0,0.
• если x равно -Бесконечности или -0,0, а y — нечётное целое число, то результат — -pow(-x ,y).
• если x равно -Бесконечности или -0,0, а y — не нечётное целое число, то результат такой же, как у pow(-x , y).
• если y равно Бесконечности, а абсолютное значение x меньше 1, результат — 0,0.
• если y равно Бесконечности и x равно -1, результат — 1,0.
• если y равно Бесконечности и абсолютное значение x больше 1, результат — Бесконечность.
• если y равно -Бесконечности, результат — 1/pow(x, Infinity).

Это соответствует функции pow определенной в стандарте IEEE Standard 754-2008.

Обратите внимание, что целочисленный результат не может переполниться, но результат с плавающей точкой двойной точности может быть double.INFINITY.

Исходный код

external num pow(num x, num exponent);