Adds square root method

Author: elliotjreed

src/ElliotJReed/Maths/Number.php

@@ -76,6 +76,13 @@ public function divide(int | float | string ...$number): self
         return $this;
     }
 
+    public function squareRoot(): self
+    {
+        $this->number = \bcsqrt($this->number, $this->precision);
+
+        return $this;
+    }
+
     public function isLessThan(int | float | string $number): bool
     {
         $result = \bccomp($this->number, (string) $number, $this->precision);

tests/ElliotJReed/Maths/NumberTest.php

@@ -492,6 +492,39 @@ public function testItDividesMultipleFloatingPointNumbersAsStringAndReturnsRound
         $this->assertSame(3, $number->asInteger(\PHP_ROUND_HALF_DOWN));
     }
 
+    public function testItReturnsTheSquareRootWhenBaseNumberIsAFloat(): void
+    {
+        $number = new Number(30.25);
+        $number->squareRoot();
+
+        $this->assertSame('5.5', $number->asString());
+        $this->assertSame(5.5, $number->asFloat());
+        $this->assertSame(6, $number->asInteger());
+        $this->assertSame(5, $number->asInteger(\PHP_ROUND_HALF_DOWN));
+    }
+
+    public function testItReturnsTheSquareRootWhenBaseNumberIsAString(): void
+    {
+        $number = new Number('30.25');
+        $number->squareRoot();
+
+        $this->assertSame('5.5', $number->asString());
+        $this->assertSame(5.5, $number->asFloat());
+        $this->assertSame(6, $number->asInteger());
+        $this->assertSame(5, $number->asInteger(\PHP_ROUND_HALF_DOWN));
+    }
+
+    public function testItReturnsTheSquareRootWhenBaseNumberIsAnInteger(): void
+    {
+        $number = new Number(25);
+        $number->squareRoot();
+
+        $this->assertSame('5', $number->asString());
+        $this->assertSame(5.0, $number->asFloat());
+        $this->assertSame(5, $number->asInteger());
+        $this->assertSame(5, $number->asInteger(\PHP_ROUND_HALF_DOWN));
+    }
+
     public function testItReturnsTrueWhenNumberIsLessThanTheBaseNumberWhenCheckingIfNumberIsLessThanBaseNumber(): void
     {
         $number = new Number('100.01');