glastree_on_gitea

vendor/brick/math/src/Exception/DivisionByZeroException.php

@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Brick\Math\Exception;
+
+/**
+ * Exception thrown when a division by zero occurs.
+ */
+final class DivisionByZeroException extends MathException
+{
+    /**
+     * @pure
+     */
+    public static function divisionByZero(): DivisionByZeroException
+    {
+        return new self('Division by zero.');
+    }
+
+    /**
+     * @pure
+     */
+    public static function modulusMustNotBeZero(): DivisionByZeroException
+    {
+        return new self('The modulus must not be zero.');
+    }
+
+    /**
+     * @pure
+     */
+    public static function denominatorMustNotBeZero(): DivisionByZeroException
+    {
+        return new self('The denominator of a rational number cannot be zero.');
+    }
+}

vendor/brick/math/src/Exception/IntegerOverflowException.php

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Brick\Math\Exception;
+
+use Brick\Math\BigInteger;
+
+use function sprintf;
+
+use const PHP_INT_MAX;
+use const PHP_INT_MIN;
+
+/**
+ * Exception thrown when an integer overflow occurs.
+ */
+final class IntegerOverflowException extends MathException
+{
+    /**
+     * @pure
+     */
+    public static function toIntOverflow(BigInteger $value): IntegerOverflowException
+    {
+        $message = '%s is out of range %d to %d and cannot be represented as an integer.';
+
+        return new self(sprintf($message, $value->toString(), PHP_INT_MIN, PHP_INT_MAX));
+    }
+}

vendor/brick/math/src/Exception/MathException.php

@@ -0,0 +1,14 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Brick\Math\Exception;
+
+use RuntimeException;
+
+/**
+ * Base class for all math exceptions.
+ */
+class MathException extends RuntimeException
+{
+}

vendor/brick/math/src/Exception/NegativeNumberException.php

@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Brick\Math\Exception;
+
+/**
+ * Exception thrown when attempting to perform an unsupported operation, such as a square root, on a negative number.
+ */
+final class NegativeNumberException extends MathException
+{
+}

vendor/brick/math/src/Exception/NumberFormatException.php

@@ -0,0 +1,60 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Brick\Math\Exception;
+
+use function dechex;
+use function ord;
+use function sprintf;
+use function strtoupper;
+
+/**
+ * Exception thrown when attempting to create a number from a string with an invalid format.
+ */
+final class NumberFormatException extends MathException
+{
+    /**
+     * @pure
+     */
+    public static function invalidFormat(string $value): self
+    {
+        return new self(sprintf(
+            'The given value "%s" does not represent a valid number.',
+            $value,
+        ));
+    }
+
+    /**
+     * @param string $char The failing character.
+     *
+     * @pure
+     */
+    public static function charNotInAlphabet(string $char): self
+    {
+        return new self(sprintf(
+            'Character %s is not valid in the given alphabet.',
+            self::charToString($char),
+        ));
+    }
+
+    /**
+     * @pure
+     */
+    private static function charToString(string $char): string
+    {
+        $ord = ord($char);
+
+        if ($ord < 32 || $ord > 126) {
+            $char = strtoupper(dechex($ord));
+
+            if ($ord < 16) {
+                $char = '0' . $char;
+            }
+
+            return '0x' . $char;
+        }
+
+        return '"' . $char . '"';
+    }
+}

vendor/brick/math/src/Exception/RoundingNecessaryException.php

@@ -0,0 +1,19 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Brick\Math\Exception;
+
+/**
+ * Exception thrown when a number cannot be represented at the requested scale without rounding.
+ */
+final class RoundingNecessaryException extends MathException
+{
+    /**
+     * @pure
+     */
+    public static function roundingNecessary(): RoundingNecessaryException
+    {
+        return new self('Rounding is necessary to represent the result of the operation at this scale.');
+    }
+}