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

# bcsqrt

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

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

### Описание

function 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() - Возводит в степень число произвольной точности
- BcMath\Number::sqrt() - Извлекает квадратный корень из числа произвольной точности

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open