111 lines
3.7 KiB
PHP
111 lines
3.7 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
/*
|
|
* This file is part of the TYPO3 CMS project.
|
|
*
|
|
* It is free software; you can redistribute it and/or modify it under
|
|
* the terms of the GNU General Public License, either version 2
|
|
* of the License, or any later version.
|
|
*
|
|
* For the full copyright and license information, please read the
|
|
* LICENSE.txt file that was distributed with this source code.
|
|
*
|
|
* The TYPO3 project - inspiring people to share!
|
|
*/
|
|
|
|
namespace TYPO3\CMS\Extbase\Persistence\Generic\Qom;
|
|
|
|
use TYPO3\CMS\Extbase\Persistence\QueryInterface;
|
|
|
|
/**
|
|
* Filters node-tuples based on the outcome of a binary operation.
|
|
*
|
|
* For any comparison, operand2 always evaluates to a scalar value. In contrast,
|
|
* operand1 may evaluate to an array of values (for example, the value of a multi-valued
|
|
* property), in which case the comparison is separately performed for each element
|
|
* of the array, and the Comparison constraint is satisfied as a whole if the
|
|
* comparison against any element of the array is satisfied.
|
|
*
|
|
* If operand1 and operand2 evaluate to values of different property types, the
|
|
* value of operand2 is converted to the property type of the value of operand1.
|
|
* If the type conversion fails, the query is invalid.
|
|
*
|
|
* If operator is not supported for the property type of operand1, the query is invalid.
|
|
*
|
|
* If operand1 evaluates to null (for example, if the operand evaluates the value
|
|
* of a property which does not exist), the constraint is not satisfied.
|
|
*
|
|
* The OPERATOR_EQUAL_TO operator is satisfied only if the value of operand1
|
|
* equals the value of operand2.
|
|
*
|
|
* The OPERATOR_NOT_EQUAL_TO operator is satisfied unless the value of
|
|
* operand1 equals the value of operand2.
|
|
*
|
|
* The OPERATOR_LESS_THAN operator is satisfied only if the value of
|
|
* operand1 is ordered before the value of operand2.
|
|
*
|
|
* The OPERATOR_LESS_THAN_OR_EQUAL_TO operator is satisfied unless the value
|
|
* of operand1 is ordered after the value of operand2.
|
|
*
|
|
* The OPERATOR_GREATER_THAN operator is satisfied only if the value of
|
|
* operand1 is ordered after the value of operand2.
|
|
*
|
|
* The OPERATOR_GREATER_THAN_OR_EQUAL_TO operator is satisfied unless the
|
|
* value of operand1 is ordered before the value of operand2.
|
|
*
|
|
* The OPERATOR_LIKE operator is satisfied only if the value of operand1
|
|
* matches the pattern specified by the value of operand2, where in the pattern:
|
|
* the character "%" matches zero or more characters, and
|
|
* the character "_" (underscore) matches exactly one character, and
|
|
* the string "\x" matches the character "x", and
|
|
* all other characters match themselves.
|
|
*
|
|
* @internal only to be used within Extbase, not part of TYPO3 Core API.
|
|
*/
|
|
final readonly class Comparison implements ComparisonInterface
|
|
{
|
|
/**
|
|
* @param QueryInterface::OPERATOR_* $operator
|
|
*/
|
|
public function __construct(
|
|
private PropertyValueInterface $operand1,
|
|
private int $operator,
|
|
private mixed $operand2
|
|
) {}
|
|
|
|
public function getOperand1(): PropertyValueInterface
|
|
{
|
|
return $this->operand1;
|
|
}
|
|
|
|
/**
|
|
* @return QueryInterface::OPERATOR_*
|
|
*/
|
|
public function getOperator(): int
|
|
{
|
|
$operator = $this->operator;
|
|
|
|
if ($this->getOperand2() === null) {
|
|
if ($operator === QueryInterface::OPERATOR_EQUAL_TO) {
|
|
$operator = QueryInterface::OPERATOR_EQUAL_TO_NULL;
|
|
} elseif ($operator === QueryInterface::OPERATOR_NOT_EQUAL_TO) {
|
|
$operator = QueryInterface::OPERATOR_NOT_EQUAL_TO_NULL;
|
|
}
|
|
}
|
|
|
|
return $operator;
|
|
}
|
|
|
|
public function getOperand2(): mixed
|
|
{
|
|
return $this->operand2;
|
|
}
|
|
|
|
public function collectBoundVariableNames(array &$boundVariables): array
|
|
{
|
|
return [];
|
|
}
|
|
}
|