WebSVN – lars-tiefland.laravel_shop – Diff – /trunk/vendor/brick/math/src/BigRational.php

+    }
     /**
      * Creates a BigRational of the given value.
-     *
-     * @param BigNumber|int|float|string $value
-     *
-     * @return BigRational
+     *
      * @throws MathException If the value cannot be converted to a BigRational.
+     *
      * @psalm-pure
      */
-    public static function of($value) : BigNumber
+    public static function of(BigNumber|int|float|string $value) : BigRational
+    {
         return parent::of($value)->toBigRational();
+    }
      * will be inverted to ensure that the denominator is always positive.
+     *
      * @param BigNumber|int|float|string $numerator   The numerator. Must be convertible to a BigInteger.
      * @param BigNumber|int|float|string $denominator The denominator. Must be convertible to a BigInteger.
+     *
-     * @return BigRational
-     *
      * @throws NumberFormatException      If an argument does not represent a valid number.
      * @throws RoundingNecessaryException If an argument represents a non-integer number.
      * @throws DivisionByZeroException    If the denominator is zero.
+     *
      * @psalm-pure
      */
-    public static function nd($numerator, $denominator) : BigRational
+    public static function nd(
+        BigNumber|int|float|string $numerator,
+        BigNumber|int|float|string $denominator,
-    {
+    ) : BigRational {
         $numerator   = BigInteger::of($numerator);
         $denominator = BigInteger::of($denominator);
         return new BigRational($numerator, $denominator, true);
+    }
     /**
-     * Returns a BigRational representing zero.
-     *
-     * @return BigRational
+     * Returns a BigRational representing zero.
+     *
      * @psalm-pure
      */
     public static function zero() : BigRational
+    }
     /**
      * Returns a BigRational representing one.
-     *
-     * @return BigRational
+     *
      * @psalm-pure
      */
     public static function one() : BigRational
+    {
+    }
     /**
      * Returns a BigRational representing ten.
-     *
-     * @return BigRational
+     *
      * @psalm-pure
      */
     public static function ten() : BigRational
+    {
+        }
         return $ten;
-    }
-    /**
      * @return BigInteger
      */
     public function getNumerator() : BigInteger
+    {
-        return $this->numerator;
-    }
-    /**
+        return $this->numerator;
      * @return BigInteger
      */
     public function getDenominator() : BigInteger
+    {
         return $this->denominator;
-    }
     /**
      * Returns the quotient of the division of the numerator by the denominator.
     /**
-     * @return BigInteger
+     * Returns the quotient of the division of the numerator by the denominator.
      */
     public function quotient() : BigInteger
+    {
-        return $this->numerator->quotient($this->denominator);
-    }
         return $this->numerator->quotient($this->denominator);
     /**
      * Returns the remainder of the division of the numerator by the denominator.
     /**
-     * @return BigInteger
+     * Returns the remainder of the division of the numerator by the denominator.
     /**
      * Returns the sum of this number and the given one.
+     *
      * @param BigNumber|int|float|string $that The number to add.
+     *
-     * @return BigRational The result.
-     *
      * @throws MathException If the number is not valid.
      */
-    public function plus($that) : BigRational
+    public function plus(BigNumber|int|float|string $that) : BigRational
+    {
         $that = BigRational::of($that);
         $numerator   = $this->numerator->multipliedBy($that->denominator);
     /**
      * Returns the difference of this number and the given one.
+     *
      * @param BigNumber|int|float|string $that The number to subtract.
+     *
-     * @return BigRational The result.
-     *
      * @throws MathException If the number is not valid.
      */
-    public function minus($that) : BigRational
+    public function minus(BigNumber|int|float|string $that) : BigRational
+    {
         $that = BigRational::of($that);
         $numerator   = $this->numerator->multipliedBy($that->denominator);
     /**
      * Returns the product of this number and the given one.
+     *
      * @param BigNumber|int|float|string $that The multiplier.
+     *
-     * @return BigRational The result.
-     *
      * @throws MathException If the multiplier is not a valid number.
      */
-    public function multipliedBy($that) : BigRational
+    public function multipliedBy(BigNumber|int|float|string $that) : BigRational
+    {
         $that = BigRational::of($that);
         $numerator   = $this->numerator->multipliedBy($that->numerator);
     /**
      * Returns the result of the division of this number by the given one.
+     *
      * @param BigNumber|int|float|string $that The divisor.
+     *
-     * @return BigRational The result.
-     *
      * @throws MathException If the divisor is not a valid number, or is zero.
      */
-    public function dividedBy($that) : BigRational
+    public function dividedBy(BigNumber|int|float|string $that) : BigRational
+    {
         $that = BigRational::of($that);
         $numerator   = $this->numerator->multipliedBy($that->denominator);
+    }
     /**
      * Returns this number exponentiated to the given value.
-     *
-     * @param int $exponent The exponent.
-     *
-     * @return BigRational The result.
+     *
      * @throws \InvalidArgumentException If the exponent is not in the range 0 to 1,000,000.
      */
     public function power(int $exponent) : BigRational
+    {
     /**
      * Returns the reciprocal of this BigRational.
+     *
      * The reciprocal has the numerator and denominator swapped.
+     *
-     * @return BigRational
-     *
      * @throws DivisionByZeroException If the numerator is zero.
      */
     public function reciprocal() : BigRational
+    {
         return new BigRational($this->denominator, $this->numerator, true);
+    }
     /**
-     * Returns the absolute value of this BigRational.
-     *
-     * @return BigRational
+     * Returns the absolute value of this BigRational.
      */
     public function abs() : BigRational
+    {
         return new BigRational($this->numerator->abs(), $this->denominator, false);
+    }
-    /**
-     * Returns the negated value of this BigRational.
     /**
-     * @return BigRational
+     * Returns the negated value of this BigRational.
      */
     public function negated() : BigRational
+    {
         return new BigRational($this->numerator->negated(), $this->denominator, false);
+    }
-    /**
      * Returns the simplified value of this BigRational.
     /**
-     * @return BigRational
+     * Returns the simplified value of this BigRational.
      */
         $denominator = $this->denominator->quotient($gcd);
         return new BigRational($numerator, $denominator, false);
-    }
-    /**
-     * {@inheritdoc}
+    }
      */
-    public function compareTo($that) : int
+    public function compareTo(BigNumber|int|float|string $that) : int
+    {
-        return $this->minus($that)->getSign();
-    }
-    /**
+        return $this->minus($that)->getSign();
      * {@inheritdoc}
      */
     public function getSign() : int
-    {
-        return $this->numerator->getSign();
-    }
+    {
-    /**
+        return $this->numerator->getSign();
      * {@inheritdoc}
      */
+        }
         return $simplified->numerator;
-    }
-    /**
      * {@inheritdoc}
      */
     public function toBigDecimal() : BigDecimal
+    {
-        return $this->numerator->toBigDecimal()->exactlyDividedBy($this->denominator);
-    }
-    /**
+        return $this->numerator->toBigDecimal()->exactlyDividedBy($this->denominator);
      * {@inheritdoc}
      */
     public function toBigRational() : BigRational
-    {
-        return $this;
-    }
+    {
-    /**
+        return $this;
      * {@inheritdoc}
      */
-    public function toScale(int $scale, int $roundingMode = RoundingMode::UNNECESSARY) : BigDecimal
-    {
-        return $this->numerator->toBigDecimal()->dividedBy($this->denominator, $scale, $roundingMode);
     public function toScale(int $scale, int $roundingMode = RoundingMode::UNNECESSARY) : BigDecimal
+    {
-    /**
+        return $this->numerator->toBigDecimal()->dividedBy($this->denominator, $scale, $roundingMode);
      * {@inheritdoc}
-     */
-    public function toInt() : int
-    {
         return $this->toBigInteger()->toInt();
     public function toInt() : int
+    {
-    /**
+        return $this->toBigInteger()->toInt();
      * {@inheritdoc}
-     */
-    public function toFloat() : float
-    {
         $simplified = $this->simplified();
-        return $simplified->numerator->toFloat() / $simplified->denominator->toFloat();
+    public function toFloat() : float
+    {
         $simplified = $this->simplified();
      * @internal
      * @psalm-suppress RedundantPropertyInitializationCheck
+     *
      * @param array{numerator: BigInteger, denominator: BigInteger} $data
+     *
-     * @return void
-     *
      * @throws \LogicException
      */
     public function __unserialize(array $data): void
+    {
         if (isset($this->numerator)) {
     /**
      * This method is required by interface Serializable and SHOULD NOT be accessed directly.
+     *
-     * @internal
-     *
-     * @return string
+     * @internal
      */
     public function serialize() : string
+    {
         return $this->numerator . '/' . $this->denominator;
      * This method is only here to implement interface Serializable and cannot be accessed directly.
+     *
      * @internal
      * @psalm-suppress RedundantPropertyInitializationCheck
+     *
-     * @param string $value
-     *
-     * @return void
-     *
      * @throws \LogicException
      */
     public function unserialize($value) : void
+    {
         if (isset($this->numerator)) {

Subversion-Projekte lars-tiefland.laravel_shop

(root)/trunk/vendor/brick/math/src/BigRational.php – Revision 148 → 399