bcsqrt

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

bcsqrtGet the square root of an arbitrary precision number

Description

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

Return the square root of the num.

Parameters

num

The operand, as a well-formed BCMath numeric string.

scale

This optional parameter is used to set the number of digits after the decimal place in the result. If omitted, it will default to the scale set globally with the bcscale() function, or fallback to 0 if this has not been set.

Return Values

Returns the square root as a well-formed BCMath numeric string.

Errors/Exceptions

This function throws a ValueError in the following cases:

  • num is not a well-formed BCMath numeric string
  • num is less than 0
  • scale is outside the valid range

Changelog

Version Description
8.0.0 If num is not a well-formed BCMath numeric string, or less than 0, a ValueError is thrown. Previously, E_WARNING was raised instead.
8.0.0 scale now needs to be between 0 and 2147483647; previously, negative scales have been silently treated as 0.
8.0.0 scale is now nullable.

Examples

Example #1 bcsqrt() example

<?php

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

?>

See Also

  • bcpow() - Raise an arbitrary precision number to another

add a note add a note

User Contributed Notes 1 note

up
1
markogrady18 at gmail dot com
10 years ago
The bcsqrt function is very handy for finding the square root of numbers in the form of strings.

//EXAMPLE:
   
<?php

$arr
= array(
       
"one" => "20",
        
"two" => "12"
   
);

echo
bcsqrt($arr["one"], 3);

//OUTPUT: 4.472
To Top