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	use Stringable;
13
14	/** @api */
15	final class Str implements Contract\Coercer
16	{
17	public string $message {
18	get => '{label} must be a string';
19	}
20
21	#[Override]
22	public function coerce(mixed $pristine, CoercionMode $mode): Contract\Coercion
23	{
24	if ($mode === CoercionMode::Strict) {
25	return self::coerceStrict($pristine);
26	}
27
28	if (!self::isCoercible($pristine)) {
29	return self::invalid($pristine);
30	}
31
32	$value = self::toString($pristine);
33
34	return new Coercion($value, $pristine, empty: self::isEmpty($value));
35	}
36
37	private static function coerceStrict(mixed $pristine): Coercion
38	{
39	if ($pristine === null) {
40	return new Coercion(null, null, empty: true);
41	}
42
43	return is_string($pristine)
44	? new Coercion($pristine, $pristine, empty: self::isEmpty($pristine))
45	: self::invalid($pristine);
46	}
47
48	private static function invalid(mixed $pristine): Coercion
49	{
50	return new Coercion(
51	$pristine,
52	$pristine,
53	Failure::invalid(),
54	);
55	}
56
57	private static function isCoercible(mixed $value): bool
58	{
59	return (
60	$value === null
61	|| is_string($value)
62	|| is_int($value)
63	|| is_float($value)
64	|| $value instanceof Stringable
65	);
66	}
67
68	private static function toString(mixed $value): ?string
69	{
70	return $value === null ? null : (string) $value;
71	}
72
73	private static function isEmpty(?string $value): bool
74	{
75	return $value === null || $value === '';
76	}
77	}

---

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.

Str->$message::get

18	get => '{label} must be a string';

Str->coerce

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

22	public function coerce(mixed $pristine, CoercionMode $mode): Contract\Coercion
23	{
24	if ($mode === CoercionMode::Strict) {
28	if (!self::isCoercible($pristine)) {
29	return self::invalid($pristine);

22	public function coerce(mixed $pristine, CoercionMode $mode): Contract\Coercion
23	{
24	if ($mode === CoercionMode::Strict) {
28	if (!self::isCoercible($pristine)) {
32	$value = self::toString($pristine);
33
34	return new Coercion($value, $pristine, empty: self::isEmpty($value));
35	}

Str->coerceStrict

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

37	private static function coerceStrict(mixed $pristine): Coercion
38	{
39	if ($pristine === null) {
43	return is_string($pristine)
44	? new Coercion($pristine, $pristine, empty: self::isEmpty($pristine))
45	: self::invalid($pristine);
46	}

37	private static function coerceStrict(mixed $pristine): Coercion
38	{
39	if ($pristine === null) {
43	return is_string($pristine)
45	: self::invalid($pristine);
45	: self::invalid($pristine);
46	}

Str->invalid

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

Str->isCoercible

57	private static function isCoercible(mixed $value): bool
58	{
59	return (
60	$value === null
61	|| is_string($value)
61	|| is_string($value)
62	|| is_int($value)
62	|| is_int($value)
63	|| is_float($value)
63	|| is_float($value)
64	|| $value instanceof Stringable
64	|| $value instanceof Stringable
65	);
66	}

57	private static function isCoercible(mixed $value): bool
58	{
59	return (
60	$value === null
61	|| is_string($value)
61	|| is_string($value)
62	|| is_int($value)
62	|| is_int($value)
63	|| is_float($value)
63	|| is_float($value)
64	|| $value instanceof Stringable
65	);
66	}

57	private static function isCoercible(mixed $value): bool
58	{
59	return (
60	$value === null
61	|| is_string($value)
61	|| is_string($value)
62	|| is_int($value)
62	|| is_int($value)
63	|| is_float($value)
64	|| $value instanceof Stringable
64	|| $value instanceof Stringable
65	);
66	}

57	private static function isCoercible(mixed $value): bool
58	{
59	return (
60	$value === null
61	|| is_string($value)
61	|| is_string($value)
62	|| is_int($value)
62	|| is_int($value)
63	|| is_float($value)
64	|| $value instanceof Stringable
65	);
66	}

57	private static function isCoercible(mixed $value): bool
58	{
59	return (
60	$value === null
61	|| is_string($value)
61	|| is_string($value)
62	|| is_int($value)
63	|| is_float($value)
63	|| is_float($value)
64	|| $value instanceof Stringable
64	|| $value instanceof Stringable
65	);
66	}

57	private static function isCoercible(mixed $value): bool
58	{
59	return (
60	$value === null
61	|| is_string($value)
61	|| is_string($value)
62	|| is_int($value)
63	|| is_float($value)
63	|| is_float($value)
64	|| $value instanceof Stringable
65	);
66	}

57	private static function isCoercible(mixed $value): bool
58	{
59	return (
60	$value === null
61	|| is_string($value)
61	|| is_string($value)
62	|| is_int($value)
63	|| is_float($value)
64	|| $value instanceof Stringable
64	|| $value instanceof Stringable
65	);
66	}

57	private static function isCoercible(mixed $value): bool
58	{
59	return (
60	$value === null
61	|| is_string($value)
61	|| is_string($value)
62	|| is_int($value)
63	|| is_float($value)
64	|| $value instanceof Stringable
65	);
66	}

57	private static function isCoercible(mixed $value): bool
58	{
59	return (
60	$value === null
61	|| is_string($value)
62	|| is_int($value)
62	|| is_int($value)
63	|| is_float($value)
63	|| is_float($value)
64	|| $value instanceof Stringable
64	|| $value instanceof Stringable
65	);
66	}

57	private static function isCoercible(mixed $value): bool
58	{
59	return (
60	$value === null
61	|| is_string($value)
62	|| is_int($value)
62	|| is_int($value)
63	|| is_float($value)
63	|| is_float($value)
64	|| $value instanceof Stringable
65	);
66	}

57	private static function isCoercible(mixed $value): bool
58	{
59	return (
60	$value === null
61	|| is_string($value)
62	|| is_int($value)
62	|| is_int($value)
63	|| is_float($value)
64	|| $value instanceof Stringable
64	|| $value instanceof Stringable
65	);
66	}

57	private static function isCoercible(mixed $value): bool
58	{
59	return (
60	$value === null
61	|| is_string($value)
62	|| is_int($value)
62	|| is_int($value)
63	|| is_float($value)
64	|| $value instanceof Stringable
65	);
66	}

57	private static function isCoercible(mixed $value): bool
58	{
59	return (
60	$value === null
61	|| is_string($value)
62	|| is_int($value)
63	|| is_float($value)
63	|| is_float($value)
64	|| $value instanceof Stringable
64	|| $value instanceof Stringable
65	);
66	}

57	private static function isCoercible(mixed $value): bool
58	{
59	return (
60	$value === null
61	|| is_string($value)
62	|| is_int($value)
63	|| is_float($value)
63	|| is_float($value)
64	|| $value instanceof Stringable
65	);
66	}

57	private static function isCoercible(mixed $value): bool
58	{
59	return (
60	$value === null
61	|| is_string($value)
62	|| is_int($value)
63	|| is_float($value)
64	|| $value instanceof Stringable
64	|| $value instanceof Stringable
65	);
66	}

57	private static function isCoercible(mixed $value): bool
58	{
59	return (
60	$value === null
61	|| is_string($value)
62	|| is_int($value)
63	|| is_float($value)
64	|| $value instanceof Stringable
65	);
66	}

Str->isEmpty

73	private static function isEmpty(?string $value): bool
74	{
75	return $value === null || $value === '';
75	return $value === null || $value === '';
75	return $value === null || $value === '';
76	}

73	private static function isEmpty(?string $value): bool
74	{
75	return $value === null || $value === '';
75	return $value === null || $value === '';
76	}

Str->toString

68	private static function toString(mixed $value): ?string
69	{
70	return $value === null ? null : (string) $value;
70	return $value === null ? null : (string) $value;
70	return $value === null ? null : (string) $value;
71	}

68	private static function toString(mixed $value): ?string
69	{
70	return $value === null ? null : (string) $value;
70	return $value === null ? null : (string) $value;
70	return $value === null ? null : (string) $value;
71	}