classUpsertTruth

packages/ztd-query-core/src/Shadow/Mutation/Upsert/UpsertTruth.php:20

final class UpsertTruth

Answers whether a value counts as true, in SQL's three-valued logic.

Null is not false: it is unknown, and it stays unknown through NOT. It only stops mattering where the other operand settles the answer on its own — one false makes an AND false, one true makes an OR true — which is what makes these different from PHP's own operators.

Type Aliases§

RowValue = import from TableDefinition

Methods§

public function __construct(private UpsertNumber $numbers = new \ZtdQuery\Shadow\Mutation\Upsert\UpsertNumber())

source §

Parameters

$numbers UpsertNumber Reads a value as the number it stands for

Calls 1

new UpsertNumber line 25

public function of(mixed $value): bool|null

source §

Answers whether a value counts as true.

Parameters

$value mixed Value to read

Returns

bool|null Whether it does, or null when the value is unknown

Throws

UnsupportedSqlException When the value is neither boolean nor a number

Test cases 4

Called from 4

Calls 3

function-call is_bool line 43
function-call in_array line 47
method-call UpsertNumber::of() line 47

public function not(mixed $value): bool|null

source §

Answers the opposite of what a value counts as.

Parameters

$value mixed Value to read

Returns

bool|null The opposite, or null when the value is unknown

Throws

UnsupportedSqlException When the value is neither boolean nor a number

Test cases 2

Called from 1

method-call ZtdQuery\Shadow\Mutation\Upsert\UpsertOperator::apply() packages/ztd-query-core/src/Shadow/Mutation/Upsert/UpsertOperator.php:60

Calls 1

method-call UpsertTruth::of() line 61

public function and(bool|null $left, bool|null $right): bool|null

source §

Answers whether both sides hold.

Parameters

`$left`	`bool\|null`	Left operand
`$right`	`bool\|null`	Right operand

Returns

bool|null Whether both do, or null when that cannot be said

Test cases 3

Called from 1

method-call ZtdQuery\Shadow\Mutation\Upsert\UpsertOperator::apply() packages/ztd-query-core/src/Shadow/Mutation/Upsert/UpsertOperator.php:72

public function or(bool|null $left, bool|null $right): bool|null

source §

Answers whether either side holds.

Parameters

`$left`	`bool\|null`	Left operand
`$right`	`bool\|null`	Right operand

Returns

bool|null Whether either does, or null when that cannot be said

Test cases 3

Called from 1

method-call ZtdQuery\Shadow\Mutation\Upsert\UpsertOperator::apply() packages/ztd-query-core/src/Shadow/Mutation/Upsert/UpsertOperator.php:73

Private surface 1§

Implementation details, listed for orientation only.

private UpsertNumber $numbers = new \ZtdQuery\Shadow\Mutation\Upsert\UpsertNumber()

Test cases 19§

Test cases that cover or call this symbol, from the coverage report and from the analyzed test sources.

Dedicated tests 12

Other tests reaching this symbol 7

Relations§

Instantiated in 2

Method calls 6

Type declarations 2