@spec ceil(float(), precision_range()) :: float()

Округляет число с плавающей запятой до наименьшего целого числа, большего или равного num.

ceil/2 также принимает точность для округления значения с плавающей запятой до произвольного количества знаков после запятой (от 0 до 15).

Операция выполняется над двоичным представлением числа с плавающей запятой без преобразования в десятичное.

Поведение ceil/2 для чисел с плавающей запятой может быть неожиданным. Например:

iex> Float.ceil(-12.52, 2)
-12.51

Можно было ожидать, что результат будет -12.52. Это не ошибка. Большинство десятичных дробей не могут быть точно представлены в двоичном формате с плавающей запятой, и поэтому число выше внутренне представлено как -12.51999999, что объясняет приведенное выше поведение.

Эта функция всегда возвращает число с плавающей запятой. Kernel.trunc/1 можно использовать для усечения результата до целого числа.

Примеры

iex> Float.ceil(34.25)
35.0
iex> Float.ceil(-56.5)
-56.0
iex> Float.ceil(34.251, 2)
34.26

@spec floor(float(), precision_range()) :: float()

Округляет число с плавающей запятой до наибольшего числа, меньшего или равного num.

floor/2 также принимает точность для округления значения с плавающей запятой до произвольного количества знаков после запятой (от 0 до 15). Операция выполняется над двоичным представлением числа с плавающей запятой без преобразования в десятичное.

Эта функция всегда возвращает число с плавающей запятой. Kernel.trunc/1 можно использовать для усечения результата до целого числа.

Известные проблемы

Поведение floor/2 для чисел с плавающей запятой может быть неожиданным. Например:

iex> Float.floor(12.52, 2)
12.51

Можно было ожидать, что результат будет 12.52. Это не ошибка. Большинство десятичных дробей не могут быть точно представлены в двоичном формате с плавающей запятой, и поэтому число выше внутренне представлено как 12.51999999, что объясняет приведенное выше поведение.

Примеры

iex> Float.floor(34.25)
34.0
iex> Float.floor(-56.5)
-57.0
iex> Float.floor(34.259, 2)
34.25

@spec parse(binary()) :: {float(), binary()} | :error

Парсит двоичную строку в число с плавающей запятой.

При успешном выполнении возвращает кортеж в формате {float, remainder_of_binary}; если двоичная строка не может быть преобразована в допустимое число с плавающей запятой, возвращается атом :error.

Если размер числа с плавающей запятой превышает максимальный размер 1.7976931348623157e+308, генерируется исключение ArgumentError.

Если необходимо преобразовать строку с числом с плавающей запятой непосредственно в число с плавающей запятой, можно использовать String.to_float/1.

Примеры

iex> Float.parse("34")
{34.0, ""}
iex> Float.parse("34.25")
{34.25, ""}
iex> Float.parse("56.5xyz")
{56.5, "xyz"}

iex> Float.parse("pi")
:error

@spec pow(float(), number()) :: float()

Вычисляет base в степени exponent.

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

Функция всегда возвращает число с плавающей запятой. Смотрите Integer.pow/2 для возведения в степень, возвращающей целые числа.

Примеры

iex> Float.pow(2.0, 0)
1.0
iex> Float.pow(2.0, 1)
2.0
iex> Float.pow(2.0, 10)
1024.0
iex> Float.pow(2.0, -1)
0.5
iex> Float.pow(2.0, -3)
0.125

iex> Float.pow(3.0, 1.5)
5.196152422706632

iex> Float.pow(-2.0, 3)
-8.0
iex> Float.pow(-2.0, 4)
16.0

iex> Float.pow(-1.0, 0.5)
** (ArithmeticError) bad argument in arithmetic expression

@spec ratio(float()) :: {integer(), pos_integer()}

Возвращает пару целых чисел, отношение которых точно равно исходному числу с плавающей запятой, а знаменатель положительный.

Примеры

iex> Float.ratio(0.0)
{0, 1}
iex> Float.ratio(3.14)
{7070651414971679, 2251799813685248}
iex> Float.ratio(-3.14)
{-7070651414971679, 2251799813685248}
iex> Float.ratio(1.5)
{3, 2}
iex> Float.ratio(-1.5)
{-3, 2}
iex> Float.ratio(16.0)
{16, 1}
iex> Float.ratio(-16.0)
{-16, 1}

@spec round(float(), precision_range()) :: float()

Округляет значение с плавающей запятой до произвольного количества знаков после запятой (от 0 до 15).

Направление округления всегда «вверх при равенстве». Операция выполняется над двоичным представлением числа с плавающей запятой без преобразования в десятичное.

Функция принимает только числа с плавающей запятой и всегда возвращает число с плавающей запятой. Используйте Kernel.round/1, если вам нужна функция, принимающая числа с плавающей запятой и целые числа и всегда возвращающая целое число.

Известные проблемы

Поведение round/2 для чисел с плавающей запятой может быть неожиданным. Например:

iex> Float.round(5.5675, 3)
5.567

Можно было ожидать, что результат будет 5.568 при округлении до ближайшего значения. Это не ошибка. Большинство десятичных дробей не могут быть точно представлены в двоичном формате с плавающей запятой, и поэтому число выше внутренне представлено как 5.567499999, что объясняет приведенное выше поведение. Если вам нужно точное округление для десятичных чисел, используйте библиотеку десятичных чисел. Приведённое выше поведение также соответствует эталонным реализациям, таким как «Правильные округления двоично-десятичных и десятично-двоичных преобразований» Дэвида М. Гэя.

Примеры

iex> Float.round(12.5)
13.0
iex> Float.round(5.5674, 3)
5.567
iex> Float.round(5.5675, 3)
5.567
iex> Float.round(-5.5674, 3)
-5.567
iex> Float.round(-5.5675)
-6.0
iex> Float.round(12.341444444444441, 15)
12.341444444444441

@spec to_charlist(float()) :: charlist()

Возвращает список символов, соответствующий текстовому представлению данного числа с плавающей запятой.

Используется самое короткое представление в соответствии с алгоритмом, описанным в «Быстрое и точное вычисление чисел с плавающей точкой» в материалах конференции SIGPLAN '96 по проектированию и реализации языков программирования.

Примеры

iex> Float.to_charlist(7.0)
'7.0'

@spec to_string(float()) :: String.t()

Возвращает двоичную строку, соответствующую текстовому представлению данного числа с плавающей запятой.

Используется самое короткое представление в соответствии с алгоритмом, описанным в «Быстрое и точное вычисление чисел с плавающей точкой» в материалах конференции SIGPLAN '96 по проектированию и реализации языков программирования.

Примеры

iex> Float.to_string(7.0)
"7.0"