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	}

---

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.

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

28	if (!self::isCoercible($pristine)) {

29	return self::invalid($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);

43	return is_string($pristine)

44	? new Coercion($pristine, $pristine, empty: self::isEmpty($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	}

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	}

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;

70	return $value === null ? null : (string) $value;
71	}