final class LogicalNot extends UnaryOperator (View source)

Methods

mixed
__invoke(mixed $actual)

No description

bool|null
evaluate(mixed $other, string $description = '', bool $returnResult = false)

Evaluates the constraint for parameter $other.

int
count()

Counts the number of constraint elements.

bool
matches(mixed $other)

Evaluates the constraint for parameter $other. Returns true if the constraint is met, false otherwise.

never
fail(mixed $other, string $description, ComparisonFailure|null $comparisonFailure = null)

Throws an exception for the given compared value and test description.

string
additionalFailureDescription(mixed $other)

Return additional failure description where needed.

string
failureDescription(mixed $other)

Returns the description of the failure.

string
toStringInContext(Operator $operator, mixed $role)

Returns a custom string representation of the constraint object when it appears in context of an $operator expression.

string
failureDescriptionInContext(Operator $operator, mixed $role, mixed $other)

Returns the description of the failure when this constraint appears in context of an $operator expression.

reduce()

Reduces the sub-expression starting at $this by skipping degenerate sub-expression and returns first descendant constraint that starts a non-reducible sub-expression.

string
valueToTypeStringFragment(mixed $value)

No description

string
operator()

Returns the name of this operator.

int
precedence()

Returns this operator's precedence.

int
arity()

Returns the number of operands (constraints).

checkConstraint(mixed $constraint)

Validates $constraint argument.

from  Operator
bool
constraintNeedsParentheses(Constraint $constraint)

Returns true if the $constraint needs to be wrapped with parentheses.

__construct(mixed $constraint)

No description

string
toString()

Returns a string representation of the constraint.

string
transformString(string $string)

Applies additional transformation to strings returned by toString() or failureDescription().

constraint()

Provides access to $this->constraint for subclasses.

static string
negate(string $string)

No description

Details

final mixed __invoke(mixed $actual)

No description

Parameters

mixed $actual

Return Value

mixed

bool|null evaluate(mixed $other, string $description = '', bool $returnResult = false)

Evaluates the constraint for parameter $other.

If $returnResult is set to false (the default), an exception is thrown in case of a failure. null is returned otherwise.

If $returnResult is true, the result of the evaluation is returned as a boolean value instead: true in case of success, false in case of a failure.

Parameters

mixed $other
string $description
bool $returnResult

Return Value

bool|null

Exceptions

ExpectationFailedException

int count()

Counts the number of constraint elements.

Return Value

int

protected bool matches(mixed $other)

Evaluates the constraint for parameter $other. Returns true if the constraint is met, false otherwise.

Parameters

mixed $other

Return Value

bool

Exceptions

ExpectationFailedException

protected never fail(mixed $other, string $description, ComparisonFailure|null $comparisonFailure = null)

Throws an exception for the given compared value and test description.

Parameters

mixed $other
string $description
ComparisonFailure|null $comparisonFailure

Return Value

never

Exceptions

ExpectationFailedException

protected string additionalFailureDescription(mixed $other)

Return additional failure description where needed.

The function can be overridden to provide additional failure information like a diff

Parameters

mixed $other

Return Value

string

protected string failureDescription(mixed $other)

Returns the description of the failure.

The beginning of failure messages is "Failed asserting that" in most cases. This method should return the second part of that sentence.

Parameters

mixed $other

Return Value

string

protected string toStringInContext(Operator $operator, mixed $role)

Returns a custom string representation of the constraint object when it appears in context of an $operator expression.

The purpose of this method is to provide meaningful descriptive string in context of operators such as LogicalNot. Native PHPUnit constraints are supported out of the box by LogicalNot, but externally developed ones had no way to provide correct strings in this context.

The method shall return empty string, when it does not handle customization by itself.

Parameters

Operator $operator
mixed $role

Return Value

string

protected string failureDescriptionInContext(Operator $operator, mixed $role, mixed $other)

Returns the description of the failure when this constraint appears in context of an $operator expression.

The purpose of this method is to provide meaningful failure description in context of operators such as LogicalNot. Native PHPUnit constraints are supported out of the box by LogicalNot, but externally developed ones had no way to provide correct messages in this context.

The method shall return empty string, when it does not handle customization by itself.

Parameters

Operator $operator
mixed $role
mixed $other

Return Value

string

protected Constraint reduce()

Reduces the sub-expression starting at $this by skipping degenerate sub-expression and returns first descendant constraint that starts a non-reducible sub-expression.

See Constraint::reduce() for more.

Return Value

Constraint

protected string valueToTypeStringFragment(mixed $value)

No description

Parameters

mixed $value

Return Value

string

string operator()

Returns the name of this operator.

Return Value

string

int precedence()

Returns this operator's precedence.

int arity()

Returns the number of operands (constraints).

Return Value

int

protected Constraint checkConstraint(mixed $constraint)

Validates $constraint argument.

Parameters

mixed $constraint

Return Value

Constraint

protected bool constraintNeedsParentheses(Constraint $constraint)

Returns true if the $constraint needs to be wrapped with parentheses.

Parameters

Constraint $constraint

Return Value

bool

__construct(mixed $constraint)

No description

Parameters

mixed $constraint

string toString()

Returns a string representation of the constraint.

Return Value

string

protected string transformString(string $string)

Applies additional transformation to strings returned by toString() or failureDescription().

Parameters

string $string

Return Value

string

final protected Constraint constraint()

Provides access to $this->constraint for subclasses.

Return Value

Constraint

static string negate(string $string)

No description

Parameters

string $string

Return Value

string