*/ final class DurationOptionParser extends OptionParser { /** @var ?float */ private $minValidValueInMilliseconds; /** @var ?float */ private $maxValidValueInMilliseconds; /** @var int */ private $defaultUnits; public function __construct( ?float $minValidValueInMilliseconds, ?float $maxValidValueInMilliseconds, int $defaultUnits ) { $this->minValidValueInMilliseconds = $minValidValueInMilliseconds; $this->maxValidValueInMilliseconds = $maxValidValueInMilliseconds; $this->defaultUnits = $defaultUnits; } /** @inheritDoc */ public function parse(string $rawValue): float { $partWithoutSuffix = ''; $units = $this->defaultUnits; self::splitToValueAndUnits($rawValue, /* ref */ $partWithoutSuffix, /* ref */ $units); $auxFloatOptionParser = new FloatOptionParser(null /* minValidValue */, null /* maxValidValue */); $parsedValueInMilliseconds = self::convertToMilliseconds($auxFloatOptionParser->parse($partWithoutSuffix), $units); if ( ( ($this->minValidValueInMilliseconds !== null) && ($parsedValueInMilliseconds < $this->minValidValueInMilliseconds) ) || ( ($this->maxValidValueInMilliseconds !== null) && ($parsedValueInMilliseconds > $this->maxValidValueInMilliseconds) ) ) { throw new ParseException( 'Value is not in range between the valid minimum and maximum values.' . ' Raw option value: `' . $rawValue . "'." . ' Parsed option value (in milliseconds): ' . $parsedValueInMilliseconds . '.' . ' The valid minimum value (in milliseconds): ' . $this->minValidValueInMilliseconds . '.' . ' The valid maximum value (in milliseconds): ' . $this->maxValidValueInMilliseconds . '.' ); } return $parsedValueInMilliseconds; } public function defaultUnits(): int { return $this->defaultUnits; } public function minValidValueInMilliseconds(): ?float { return $this->minValidValueInMilliseconds; } public function maxValidValueInMilliseconds(): ?float { return $this->maxValidValueInMilliseconds; } private static function splitToValueAndUnits(string $rawValue, string &$partWithoutSuffix, int &$units): void { foreach (DurationUnits::$suffixAndIdPairs as $suffixAndIdPair) { $suffix = $suffixAndIdPair[0]; if (TextUtil::isSuffixOf($suffix, $rawValue, /* isCaseSensitive */ false)) { $partWithoutSuffix = trim(substr($rawValue, 0, -strlen($suffix))); $units = $suffixAndIdPair[1]; return; } } $partWithoutSuffix = $rawValue; } public static function convertToMilliseconds(float $srcValue, int $srcValueUnits): float { switch ($srcValueUnits) { case DurationUnits::MILLISECONDS: return $srcValue; case DurationUnits::SECONDS: return $srcValue * 1000; case DurationUnits::MINUTES: return $srcValue * 60 * 1000; default: throw new ParseException( ExceptionUtil::buildMessage( 'Not a valid time duration units ID', /* context */ [ 'srcValueUnits' => $srcValueUnits, 'srcValue' => $srcValue, 'valid time duration units' => DurationUnits::$suffixAndIdPairs, ] ) ); } } }