1	<?php
2
3	declare(strict_types=1);
4
5	namespace Celemas\Sire\Coercer;
6
7	use Celemas\Sire\Coercion;
8	use Celemas\Sire\CoercionMode;
9	use Celemas\Sire\Contract;
10	use Celemas\Sire\Failure;
11	use Override;
12
13	/** @api */
14	final class Number implements Contract\Coercer
15	{
16	public string $message {
17	get => '{label} must be a number';
18	}
19
20	#[Override]
21	public function coerce(mixed $pristine, CoercionMode $mode): Contract\Coercion
22	{
23	if ($mode === CoercionMode::Strict) {
24	return self::coerceStrict($pristine);
25	}
26
27	$value = self::toNumber($pristine);
28
29	if ($value === null && $pristine !== null) {
30	return self::invalid($pristine);
31	}
32
33	return new Coercion($value, $pristine, empty: $value === null);
34	}
35
36	private static function coerceStrict(mixed $pristine): Coercion
37	{
38	if ($pristine === null) {
39	return new Coercion(null, null, empty: true);
40	}
41
42	return is_int($pristine) || is_float($pristine) && is_finite($pristine)
43	? new Coercion($pristine, $pristine)
44	: self::invalid($pristine);
45	}
46
47	private static function invalid(mixed $pristine): Coercion
48	{
49	return new Coercion(
50	$pristine,
51	$pristine,
52	Failure::invalid(),
53	empty: self::isEmpty($pristine),
54	);
55	}
56
57	private static function isEmpty(mixed $value): bool
58	{
59	return $value === null || is_string($value) && trim($value) === '';
60	}
61
62	private static function toNumber(mixed $value): int|float|null
63	{
64	if ($value === null || is_int($value)) {
65	return $value;
66	}
67
68	if (is_float($value)) {
69	return self::finiteFloat($value);
70	}
71
72	return self::isNumericString($value)
73	? self::fromNumericString(trim($value))
74	: null;
75	}
76
77	private static function isNumericString(mixed $value): bool
78	{
79	return is_string($value) && is_numeric($value);
80	}
81
82	private static function fromNumericString(string $value): int|float|null
83	{
84	$integer = filter_var($value, FILTER_VALIDATE_INT);
85
86	if ($integer !== false) {
87	return $integer;
88	}
89
90	return self::finiteFloat((float) $value);
91	}
92
93	private static function finiteFloat(float $value): ?float
94	{
95	return is_finite($value) ? $value : null;
96	}
97	}

---

Paths

Below are the source code lines that represent each code path as identified by Xdebug. Please note a path is not necessarily coterminous with a line, a line may contain multiple paths and therefore show up more than once. Please also be aware that some paths may include implicit rather than explicit branches, e.g. an if statement always has an else as part of its logical flow even if you didn't write one.

Number->$message::get

17	get => '{label} must be a number';

Number->coerce

21	public function coerce(mixed $pristine, CoercionMode $mode): Contract\Coercion
22	{
23	if ($mode === CoercionMode::Strict) {
24	return self::coerceStrict($pristine);

21	public function coerce(mixed $pristine, CoercionMode $mode): Contract\Coercion
22	{
23	if ($mode === CoercionMode::Strict) {
27	$value = self::toNumber($pristine);
28
29	if ($value === null && $pristine !== null) {
29	if ($value === null && $pristine !== null) {
29	if ($value === null && $pristine !== null) {
30	return self::invalid($pristine);

21	public function coerce(mixed $pristine, CoercionMode $mode): Contract\Coercion
22	{
23	if ($mode === CoercionMode::Strict) {
27	$value = self::toNumber($pristine);
28
29	if ($value === null && $pristine !== null) {
29	if ($value === null && $pristine !== null) {
29	if ($value === null && $pristine !== null) {
33	return new Coercion($value, $pristine, empty: $value === null);
34	}

21	public function coerce(mixed $pristine, CoercionMode $mode): Contract\Coercion
22	{
23	if ($mode === CoercionMode::Strict) {
27	$value = self::toNumber($pristine);
28
29	if ($value === null && $pristine !== null) {
29	if ($value === null && $pristine !== null) {
30	return self::invalid($pristine);

21	public function coerce(mixed $pristine, CoercionMode $mode): Contract\Coercion
22	{
23	if ($mode === CoercionMode::Strict) {
27	$value = self::toNumber($pristine);
28
29	if ($value === null && $pristine !== null) {
29	if ($value === null && $pristine !== null) {
33	return new Coercion($value, $pristine, empty: $value === null);
34	}

Number->coerceStrict

36	private static function coerceStrict(mixed $pristine): Coercion
37	{
38	if ($pristine === null) {
39	return new Coercion(null, null, empty: true);

36	private static function coerceStrict(mixed $pristine): Coercion
37	{
38	if ($pristine === null) {
42	return is_int($pristine) || is_float($pristine) && is_finite($pristine)
42	return is_int($pristine) || is_float($pristine) && is_finite($pristine)
42	return is_int($pristine) || is_float($pristine) && is_finite($pristine)
42	return is_int($pristine) || is_float($pristine) && is_finite($pristine)
42	return is_int($pristine) || is_float($pristine) && is_finite($pristine)
43	? new Coercion($pristine, $pristine)
44	: self::invalid($pristine);
45	}

36	private static function coerceStrict(mixed $pristine): Coercion
37	{
38	if ($pristine === null) {
42	return is_int($pristine) || is_float($pristine) && is_finite($pristine)
42	return is_int($pristine) || is_float($pristine) && is_finite($pristine)
42	return is_int($pristine) || is_float($pristine) && is_finite($pristine)
42	return is_int($pristine) || is_float($pristine) && is_finite($pristine)
42	return is_int($pristine) || is_float($pristine) && is_finite($pristine)
44	: self::invalid($pristine);
44	: self::invalid($pristine);
45	}

36	private static function coerceStrict(mixed $pristine): Coercion
37	{
38	if ($pristine === null) {
42	return is_int($pristine) || is_float($pristine) && is_finite($pristine)
42	return is_int($pristine) || is_float($pristine) && is_finite($pristine)
42	return is_int($pristine) || is_float($pristine) && is_finite($pristine)
42	return is_int($pristine) || is_float($pristine) && is_finite($pristine)
43	? new Coercion($pristine, $pristine)
44	: self::invalid($pristine);
45	}

36	private static function coerceStrict(mixed $pristine): Coercion
37	{
38	if ($pristine === null) {
42	return is_int($pristine) || is_float($pristine) && is_finite($pristine)
42	return is_int($pristine) || is_float($pristine) && is_finite($pristine)
42	return is_int($pristine) || is_float($pristine) && is_finite($pristine)
42	return is_int($pristine) || is_float($pristine) && is_finite($pristine)
44	: self::invalid($pristine);
44	: self::invalid($pristine);
45	}

36	private static function coerceStrict(mixed $pristine): Coercion
37	{
38	if ($pristine === null) {
42	return is_int($pristine) || is_float($pristine) && is_finite($pristine)
42	return is_int($pristine) || is_float($pristine) && is_finite($pristine)
43	? new Coercion($pristine, $pristine)
44	: self::invalid($pristine);
45	}

36	private static function coerceStrict(mixed $pristine): Coercion
37	{
38	if ($pristine === null) {
42	return is_int($pristine) || is_float($pristine) && is_finite($pristine)
42	return is_int($pristine) || is_float($pristine) && is_finite($pristine)
44	: self::invalid($pristine);
44	: self::invalid($pristine);
45	}

Number->finiteFloat

93	private static function finiteFloat(float $value): ?float
94	{
95	return is_finite($value) ? $value : null;
95	return is_finite($value) ? $value : null;
95	return is_finite($value) ? $value : null;
96	}

93	private static function finiteFloat(float $value): ?float
94	{
95	return is_finite($value) ? $value : null;
95	return is_finite($value) ? $value : null;
95	return is_finite($value) ? $value : null;
96	}

Number->fromNumericString

82	private static function fromNumericString(string $value): int|float|null
83	{
84	$integer = filter_var($value, FILTER_VALIDATE_INT);
85
86	if ($integer !== false) {
87	return $integer;

82	private static function fromNumericString(string $value): int|float|null
83	{
84	$integer = filter_var($value, FILTER_VALIDATE_INT);
85
86	if ($integer !== false) {
90	return self::finiteFloat((float) $value);
91	}

Number->invalid

47	private static function invalid(mixed $pristine): Coercion
48	{
49	return new Coercion(
50	$pristine,
51	$pristine,
52	Failure::invalid(),
53	empty: self::isEmpty($pristine),
54	);
55	}

Number->isEmpty

57	private static function isEmpty(mixed $value): bool
58	{
59	return $value === null || is_string($value) && trim($value) === '';
59	return $value === null || is_string($value) && trim($value) === '';
59	return $value === null || is_string($value) && trim($value) === '';
59	return $value === null || is_string($value) && trim($value) === '';
59	return $value === null || is_string($value) && trim($value) === '';
59	return $value === null || is_string($value) && trim($value) === '';
59	return $value === null || is_string($value) && trim($value) === '';
60	}

57	private static function isEmpty(mixed $value): bool
58	{
59	return $value === null || is_string($value) && trim($value) === '';
59	return $value === null || is_string($value) && trim($value) === '';
59	return $value === null || is_string($value) && trim($value) === '';
59	return $value === null || is_string($value) && trim($value) === '';
59	return $value === null || is_string($value) && trim($value) === '';
59	return $value === null || is_string($value) && trim($value) === '';
59	return $value === null || is_string($value) && trim($value) === '';
60	}

57	private static function isEmpty(mixed $value): bool
58	{
59	return $value === null || is_string($value) && trim($value) === '';
59	return $value === null || is_string($value) && trim($value) === '';
59	return $value === null || is_string($value) && trim($value) === '';
59	return $value === null || is_string($value) && trim($value) === '';
60	}

57	private static function isEmpty(mixed $value): bool
58	{
59	return $value === null || is_string($value) && trim($value) === '';
59	return $value === null || is_string($value) && trim($value) === '';
60	}

Number->isNumericString

77	private static function isNumericString(mixed $value): bool
78	{
79	return is_string($value) && is_numeric($value);
79	return is_string($value) && is_numeric($value);
79	return is_string($value) && is_numeric($value);
79	return is_string($value) && is_numeric($value);
79	return is_string($value) && is_numeric($value);
80	}

77	private static function isNumericString(mixed $value): bool
78	{
79	return is_string($value) && is_numeric($value);
79	return is_string($value) && is_numeric($value);
79	return is_string($value) && is_numeric($value);
79	return is_string($value) && is_numeric($value);
79	return is_string($value) && is_numeric($value);
80	}

77	private static function isNumericString(mixed $value): bool
78	{
79	return is_string($value) && is_numeric($value);
79	return is_string($value) && is_numeric($value);
80	}

Number->toNumber

62	private static function toNumber(mixed $value): int|float|null
63	{
64	if ($value === null || is_int($value)) {
64	if ($value === null || is_int($value)) {
64	if ($value === null || is_int($value)) {
65	return $value;

62	private static function toNumber(mixed $value): int|float|null
63	{
64	if ($value === null || is_int($value)) {
64	if ($value === null || is_int($value)) {
64	if ($value === null || is_int($value)) {
68	if (is_float($value)) {
69	return self::finiteFloat($value);

62	private static function toNumber(mixed $value): int|float|null
63	{
64	if ($value === null || is_int($value)) {
64	if ($value === null || is_int($value)) {
64	if ($value === null || is_int($value)) {
68	if (is_float($value)) {
72	return self::isNumericString($value)
73	? self::fromNumericString(trim($value))
73	? self::fromNumericString(trim($value))
73	? self::fromNumericString(trim($value))
74	: null;
75	}

62	private static function toNumber(mixed $value): int|float|null
63	{
64	if ($value === null || is_int($value)) {
64	if ($value === null || is_int($value)) {
64	if ($value === null || is_int($value)) {
68	if (is_float($value)) {
72	return self::isNumericString($value)
73	? self::fromNumericString(trim($value))
73	? self::fromNumericString(trim($value))
73	? self::fromNumericString(trim($value))
74	: null;
75	}

62	private static function toNumber(mixed $value): int|float|null
63	{
64	if ($value === null || is_int($value)) {
64	if ($value === null || is_int($value)) {
64	if ($value === null || is_int($value)) {
68	if (is_float($value)) {
72	return self::isNumericString($value)
74	: null;
74	: null;
75	}

62	private static function toNumber(mixed $value): int|float|null
63	{
64	if ($value === null || is_int($value)) {
64	if ($value === null || is_int($value)) {
65	return $value;

62	private static function toNumber(mixed $value): int|float|null
63	{
64	if ($value === null || is_int($value)) {
64	if ($value === null || is_int($value)) {
68	if (is_float($value)) {
69	return self::finiteFloat($value);

62	private static function toNumber(mixed $value): int|float|null
63	{
64	if ($value === null || is_int($value)) {
64	if ($value === null || is_int($value)) {
68	if (is_float($value)) {
72	return self::isNumericString($value)
73	? self::fromNumericString(trim($value))
73	? self::fromNumericString(trim($value))
73	? self::fromNumericString(trim($value))
74	: null;
75	}

62	private static function toNumber(mixed $value): int|float|null
63	{
64	if ($value === null || is_int($value)) {
64	if ($value === null || is_int($value)) {
68	if (is_float($value)) {
72	return self::isNumericString($value)
73	? self::fromNumericString(trim($value))
73	? self::fromNumericString(trim($value))
73	? self::fromNumericString(trim($value))
74	: null;
75	}

62	private static function toNumber(mixed $value): int|float|null
63	{
64	if ($value === null || is_int($value)) {
64	if ($value === null || is_int($value)) {
68	if (is_float($value)) {
72	return self::isNumericString($value)
74	: null;
74	: null;
75	}