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	}

---

Branches

Below are the source code lines that represent each code branch as identified by Xdebug. Please note a branch is not necessarily coterminous with a line, a line may contain multiple branches and therefore show up more than once. Please also be aware that some branches may be implicit rather than explicit, 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);

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);

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);

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);

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;

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;

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) === '';

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);

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;

68	if (is_float($value)) {

69	return self::finiteFloat($value);

72	return self::isNumericString($value)

73	? self::fromNumericString(trim($value))

73	? self::fromNumericString(trim($value))

73	? self::fromNumericString(trim($value))

73	? self::fromNumericString(trim($value))

74

: null;

74	: null;
75	}