PHP Conference Nagoya 2025

bcsqrt

(PHP 4, PHP 5, PHP 7, PHP 8)

bcsqrt Извлекает квадратный корень из числа произвольной точности

Описание

bcsqrt(string $num, ?int $scale = null): string

Функция возвращает квадратный корень из числа num.

Список параметров

num

Операнд, подкоренное выражение, в виде корректно сформированной числовой строки BCMath.

scale
Параметр устанавливает количество знаков после десятичного разделителя, которое вернётся в результате. При значении null количество знаков после десятичного разделителя равняется значению по умолчанию, которое установили для параметра глобально функцией bcscale(), или резервному значению, которое указали в INI-директиве bcmath.scale, если глобальное значение не установили.

Возвращаемые значения

Функция возвращает квадратный корень в виде корректно сформированной числовой строки BCMath.

Ошибки

Функция выбрасывает ошибку ValueError в следующих случаях:

  • Значение аргумента num оказалось строкой, которую сформировали неправильно с точки зрения допустимого формата числовых строк в модуле BCMath
  • Значение аргумента num меньше, чем 0
  • Значение аргумента scale выходит за пределы допустимого диапазона

Список изменений

Версия Описание
8.0.0 Функция выбрасывается ошибку ValueError, если значение аргумента num оказалось строкой, которую сформировали неправильно с точки зрения допустимого формата числовых строк в модуле BCMath, или меньше 0; раньше вместо этого выдавалась ошибка уровня E_WARNING.
8.0.0 Допустимый диапазон значений параметра scale теперь лежит в пределах значений от 0 до 2147483647; раньше функция воспринимала отрицательные значения как 0.
8.0.0 Параметр scale теперь принимает значение null.

Примеры

Пример #1 Пример извлечения квадратного корня функцией bcsqrt()

<?php

echo bcsqrt('2', 3); // 1.414

?>

Смотрите также

  • bcpow() - Возводит в степень число произвольной точности

Добавить

Примечания пользователей

Пользователи ещё не добавляли примечания для страницы
To Top