NonNegativeDecimal.php

<?php

declare(strict_types=1);

namespace Epignosis\Types\Number;

use InvalidArgumentException;

class NonNegativeDecimal extends Decimal
{
    /**
     * @param  float  $value
     * @param  int  $precision  < max : 16>
     * @param  int  $rounding  (1 : PHP_ROUND_HALF_UP (Default), 2 : PHP_ROUND_HALF_DOWN,
     *                          3 : PHP_ROUND_HALF_EVEN, 4 : PHP_ROUND_HALF_ODD)
     */
    public function __construct($value, int $precision = 2, int $rounding = PHP_ROUND_HALF_UP)
    {
        if ($value < 0) {
            throw new InvalidArgumentException('Value must be a non-negative decimal number.');
        }

        parent::__construct($value, $precision, $rounding);
    }

    /**
     * @param  int|float|string  $value
     * @param  int  $precision
     * @param  int  $rounding  (1 : PHP_ROUND_HALF_UP, 2 : PHP_ROUND_HALF_DOWN,
     *                          3 : PHP_ROUND_HALF_EVEN, 4 : PHP_ROUND_HALF_ODD)
     * @return self
     */
    public static function fromNumeric($value, int $precision = 2, int $rounding = PHP_ROUND_HALF_UP): self
    {
        if (!is_numeric($value)) {
            throw new InvalidArgumentException('Value is not numeric.');
        }

        $value = (float)$value;

        return new self($value, $precision, $rounding);
    }
}