ExpressionBuilder::lt() - Code Metrics - Inspection of "Merge pull request #3994 from greg0ire/check-for-a..." - doctrine/dbal - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Push — 2.10.x ( 61a6b9...f20ba1 )

by Grégoire

created 2020-05-07 07:07 UTC

ExpressionBuilder::lt() A

↳ Parent: ExpressionBuilder

Complexity

Conditions	1
Paths	1

Size

Total Lines	3
Code Lines	1

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	2
CRAP Score	1

Importance

Changes

Metric	Value
dl	0
loc	3
ccs	2
cts	2
cp	1
rs	10
c	0
b	0
f	0
cc	1
eloc	1
nc	1
nop	2
crap	1

<?php

namespace Doctrine\DBAL\Query\Expression;

use Doctrine\DBAL\Connection;
use function func_get_arg;
use function func_get_args;
use function func_num_args;
use function implode;
use function sprintf;

/**
 * ExpressionBuilder class is responsible to dynamically create SQL query parts.
 */
class ExpressionBuilder
{
    public const EQ  = '=';
    public const NEQ = '<>';
    public const LT  = '<';
    public const LTE = '<=';
    public const GT  = '>';
    public const GTE = '>=';

    /**
     * The DBAL Connection.
     *
     * @var Connection
     */
    private $connection;

    /**
     * Initializes a new <tt>ExpressionBuilder</tt>.
     *
     * @param Connection $connection The DBAL Connection.
     */
    public function __construct(Connection $connection)
    {
        $this->connection = $connection;
    }

    /**
     * Creates a conjunction of the given boolean expressions.
     *
     * Example:
     *
     *     [php]
     *     // (u.type = ?) AND (u.role = ?)
     *     $expr->andX('u.type = ?', 'u.role = ?'));
     *
     * @param mixed $x Optional clause. Defaults = null, but requires
     *                 at least one defined when converting to string.
     *
     * @return CompositeExpression
     */
    public function andX($x = null)
    {
        return new CompositeExpression(CompositeExpression::TYPE_AND, func_get_args());
    }

    /**
     * Creates a disjunction of the given boolean expressions.
     *
     * Example:
     *
     *     [php]
     *     // (u.type = ?) OR (u.role = ?)
     *     $qb->where($qb->expr()->orX('u.type = ?', 'u.role = ?'));
     *
     * @param mixed $x Optional clause. Defaults = null, but requires
     *                 at least one defined when converting to string.
     *
     * @return CompositeExpression
     */
    public function orX($x = null)
    {
        return new CompositeExpression(CompositeExpression::TYPE_OR, func_get_args());
    }

    /**
     * Creates a comparison expression.
     *
     * @param mixed  $x        The left expression.
     * @param string $operator One of the ExpressionBuilder::* constants.
     * @param mixed  $y        The right expression.
     *
     * @return string
     */
    public function comparison($x, $operator, $y)
    {
        return $x . ' ' . $operator . ' ' . $y;
    }

    /**
     * Creates an equality comparison expression with the given arguments.
     *
     * First argument is considered the left expression and the second is the right expression.
     * When converted to string, it will generated a <left expr> = <right expr>. Example:
     *
     *     [php]
     *     // u.id = ?
     *     $expr->eq('u.id', '?');
     *
     * @param mixed $x The left expression.
     * @param mixed $y The right expression.
     *
     * @return string
     */
    public function eq($x, $y)
    {
        return $this->comparison($x, self::EQ, $y);
    }

    /**
     * Creates a non equality comparison expression with the given arguments.
     * First argument is considered the left expression and the second is the right expression.
     * When converted to string, it will generated a <left expr> <> <right expr>. Example:
     *
     *     [php]
     *     // u.id <> 1
     *     $q->where($q->expr()->neq('u.id', '1'));
     *
     * @param mixed $x The left expression.
     * @param mixed $y The right expression.
     *
     * @return string
     */
    public function neq($x, $y)
    {
        return $this->comparison($x, self::NEQ, $y);
    }

    /**
     * Creates a lower-than comparison expression with the given arguments.
     * First argument is considered the left expression and the second is the right expression.
     * When converted to string, it will generated a <left expr> < <right expr>. Example:
     *
     *     [php]
     *     // u.id < ?
     *     $q->where($q->expr()->lt('u.id', '?'));
     *
     * @param mixed $x The left expression.
     * @param mixed $y The right expression.
     *
     * @return string
     */
    public function lt($x, $y)
    {
        return $this->comparison($x, self::LT, $y);
    }

    /**
     * Creates a lower-than-equal comparison expression with the given arguments.
     * First argument is considered the left expression and the second is the right expression.
     * When converted to string, it will generated a <left expr> <= <right expr>. Example:
     *
     *     [php]
     *     // u.id <= ?
     *     $q->where($q->expr()->lte('u.id', '?'));
     *
     * @param mixed $x The left expression.
     * @param mixed $y The right expression.
     *
     * @return string
     */
    public function lte($x, $y)
    {
        return $this->comparison($x, self::LTE, $y);
    }

    /**
     * Creates a greater-than comparison expression with the given arguments.
     * First argument is considered the left expression and the second is the right expression.
     * When converted to string, it will generated a <left expr> > <right expr>. Example:
     *
     *     [php]
     *     // u.id > ?
     *     $q->where($q->expr()->gt('u.id', '?'));
     *
     * @param mixed $x The left expression.
     * @param mixed $y The right expression.
     *
     * @return string
     */
    public function gt($x, $y)
    {
        return $this->comparison($x, self::GT, $y);
    }

    /**
     * Creates a greater-than-equal comparison expression with the given arguments.
     * First argument is considered the left expression and the second is the right expression.
     * When converted to string, it will generated a <left expr> >= <right expr>. Example:
     *
     *     [php]
     *     // u.id >= ?
     *     $q->where($q->expr()->gte('u.id', '?'));
     *
     * @param mixed $x The left expression.
     * @param mixed $y The right expression.
     *
     * @return string
     */
    public function gte($x, $y)
    {
        return $this->comparison($x, self::GTE, $y);
    }

    /**
     * Creates an IS NULL expression with the given arguments.
     *
     * @param string $x The field in string format to be restricted by IS NULL.
     *
     * @return string
     */
    public function isNull($x)
    {
        return $x . ' IS NULL';
    }

    /**
     * Creates an IS NOT NULL expression with the given arguments.
     *
     * @param string $x The field in string format to be restricted by IS NOT NULL.
     *
     * @return string
     */
    public function isNotNull($x)
    {
        return $x . ' IS NOT NULL';
    }

    /**
     * Creates a LIKE() comparison expression with the given arguments.
     *
     * @param string $x Field in string format to be inspected by LIKE() comparison.
     * @param mixed  $y Argument to be used in LIKE() comparison.
     *
     * @return string
     */
    public function like($x, $y/*, ?string $escapeChar = null */)
    {
        return $this->comparison($x, 'LIKE', $y) .
            (func_num_args() >= 3 ? sprintf(' ESCAPE %s', func_get_arg(2)) : '');
    }

    /**
     * Creates a NOT LIKE() comparison expression with the given arguments.
     *
     * @param string $x Field in string format to be inspected by NOT LIKE() comparison.
     * @param mixed  $y Argument to be used in NOT LIKE() comparison.
     *
     * @return string
     */
    public function notLike($x, $y/*, ?string $escapeChar = null */)
    {
        return $this->comparison($x, 'NOT LIKE', $y) .
            (func_num_args() >= 3 ? sprintf(' ESCAPE %s', func_get_arg(2)) : '');
    }

    /**
     * Creates a IN () comparison expression with the given arguments.
     *
     * @param string          $x The field in string format to be inspected by IN() comparison.
     * @param string|string[] $y The placeholder or the array of values to be used by IN() comparison.
     *
     * @return string
     */
    public function in($x, $y)
    {
        return $this->comparison($x, 'IN', '(' . implode(', ', (array) $y) . ')');
    }

    /**
     * Creates a NOT IN () comparison expression with the given arguments.
     *
     * @param string          $x The field in string format to be inspected by NOT IN() comparison.
     * @param string|string[] $y The placeholder or the array of values to be used by NOT IN() comparison.
     *
     * @return string
     */
    public function notIn($x, $y)
    {
        return $this->comparison($x, 'NOT IN', '(' . implode(', ', (array) $y) . ')');
    }

    /**
     * Quotes a given input parameter.
     *
     * @param mixed    $input The parameter to be quoted.
     * @param int|null $type  The type of the parameter.
     *
     * @return string
     */
    public function literal($input, $type = null)
    {
        return $this->connection->quote($input, $type);
    }
}


1		<?php
2
3		namespace Doctrine\DBAL\Query\Expression;
4
5		use Doctrine\DBAL\Connection;
6		use function func_get_arg;
7		use function func_get_args;
8		use function func_num_args;
9		use function implode;
10		use function sprintf;
11
12		/**
13		* ExpressionBuilder class is responsible to dynamically create SQL query parts.
14		*/
15		class ExpressionBuilder
16		{
17		public const EQ = '=';
18		public const NEQ = '<>';
19		public const LT = '<';
20		public const LTE = '<=';
21		public const GT = '>';
22		public const GTE = '>=';
23
24		/**
25		* The DBAL Connection.
26		*
27		* @var Connection
28		*/
29		private $connection;
30
31		/**
32		* Initializes a new <tt>ExpressionBuilder</tt>.
33		*
34		* @param Connection $connection The DBAL Connection.
35		*/
36	4898	public function __construct(Connection $connection)
37		{
38	4898	$this->connection = $connection;
39	4898	}
40
41		/**
42		* Creates a conjunction of the given boolean expressions.
43		*
44		* Example:
45		*
46		* [php]
47		* // (u.type = ?) AND (u.role = ?)
48		* $expr->andX('u.type = ?', 'u.role = ?'));
49		*
50		* @param mixed $x Optional clause. Defaults = null, but requires
51		* at least one defined when converting to string.
52		*
53		* @return CompositeExpression
54		*/
55	2284	public function andX($x = null)
56		{
57	2284	return new CompositeExpression(CompositeExpression::TYPE_AND, func_get_args());
58		}
59
60		/**
61		* Creates a disjunction of the given boolean expressions.
62		*
63		* Example:
64		*
65		* [php]
66		* // (u.type = ?) OR (u.role = ?)
67		* $qb->where($qb->expr()->orX('u.type = ?', 'u.role = ?'));
68		*
69		* @param mixed $x Optional clause. Defaults = null, but requires
70		* at least one defined when converting to string.
71		*
72		* @return CompositeExpression
73		*/
74	2168	public function orX($x = null)
75		{
76	2168	return new CompositeExpression(CompositeExpression::TYPE_OR, func_get_args());
77		}
78
79		/**
80		* Creates a comparison expression.
81		*
82		* @param mixed $x The left expression.
83		* @param string $operator One of the ExpressionBuilder::* constants.
84		* @param mixed $y The right expression.
85		*
86		* @return string
87		*/
88	2075	public function comparison($x, $operator, $y)
89		{
90	2075	return $x . ' ' . $operator . ' ' . $y;
91		}
92
93		/**
94		* Creates an equality comparison expression with the given arguments.
95		*
96		* First argument is considered the left expression and the second is the right expression.
97		* When converted to string, it will generated a <left expr> = <right expr>. Example:
98		*
99		* [php]
100		* // u.id = ?
101		* $expr->eq('u.id', '?');
102		*
103		* @param mixed $x The left expression.
104		* @param mixed $y The right expression.
105		*
106		* @return string
107		*/
108	2033	public function eq($x, $y)
109		{
110	2033	return $this->comparison($x, self::EQ, $y);
111		}
112
113		/**
114		* Creates a non equality comparison expression with the given arguments.
115		* First argument is considered the left expression and the second is the right expression.
116		* When converted to string, it will generated a <left expr> <> <right expr>. Example:
117		*
118		* [php]
119		* // u.id <> 1
120		* $q->where($q->expr()->neq('u.id', '1'));
121		*
122		* @param mixed $x The left expression.
123		* @param mixed $y The right expression.
124		*
125		* @return string
126		*/
127	1	public function neq($x, $y)
128		{
129	1	return $this->comparison($x, self::NEQ, $y);
130		}
131
132		/**
133		* Creates a lower-than comparison expression with the given arguments.
134		* First argument is considered the left expression and the second is the right expression.
135		* When converted to string, it will generated a <left expr> < <right expr>. Example:
136		*
137		* [php]
138		* // u.id < ?
139		* $q->where($q->expr()->lt('u.id', '?'));
140		*
141		* @param mixed $x The left expression.
142		* @param mixed $y The right expression.
143		*
144		* @return string
145		*/
146	1	public function lt($x, $y)
147		{
148	1	return $this->comparison($x, self::LT, $y);
149		}
150
151		/**
152		* Creates a lower-than-equal comparison expression with the given arguments.
153		* First argument is considered the left expression and the second is the right expression.
154		* When converted to string, it will generated a <left expr> <= <right expr>. Example:
155		*
156		* [php]
157		* // u.id <= ?
158		* $q->where($q->expr()->lte('u.id', '?'));
159		*
160		* @param mixed $x The left expression.
161		* @param mixed $y The right expression.
162		*
163		* @return string
164		*/
165	1	public function lte($x, $y)
166		{
167	1	return $this->comparison($x, self::LTE, $y);
168		}
169
170		/**
171		* Creates a greater-than comparison expression with the given arguments.
172		* First argument is considered the left expression and the second is the right expression.
173		* When converted to string, it will generated a <left expr> > <right expr>. Example:
174		*
175		* [php]
176		* // u.id > ?
177		* $q->where($q->expr()->gt('u.id', '?'));
178		*
179		* @param mixed $x The left expression.
180		* @param mixed $y The right expression.
181		*
182		* @return string
183		*/
184	1	public function gt($x, $y)
185		{
186	1	return $this->comparison($x, self::GT, $y);
187		}
188
189		/**
190		* Creates a greater-than-equal comparison expression with the given arguments.
191		* First argument is considered the left expression and the second is the right expression.
192		* When converted to string, it will generated a <left expr> >= <right expr>. Example:
193		*
194		* [php]
195		* // u.id >= ?
196		* $q->where($q->expr()->gte('u.id', '?'));
197		*
198		* @param mixed $x The left expression.
199		* @param mixed $y The right expression.
200		*
201		* @return string
202		*/
203	1	public function gte($x, $y)
204		{
205	1	return $this->comparison($x, self::GTE, $y);
206		}
207
208		/**
209		* Creates an IS NULL expression with the given arguments.
210		*
211		* @param string $x The field in string format to be restricted by IS NULL.
212		*
213		* @return string
214		*/
215	2002	public function isNull($x)
216		{
217	2002	return $x . ' IS NULL';
218		}
219
220		/**
221		* Creates an IS NOT NULL expression with the given arguments.
222		*
223		* @param string $x The field in string format to be restricted by IS NOT NULL.
224		*
225		* @return string
226		*/
227	1	public function isNotNull($x)
228		{
229	1	return $x . ' IS NOT NULL';
230		}
231
232		/**
233		* Creates a LIKE() comparison expression with the given arguments.
234		*
235		* @param string $x Field in string format to be inspected by LIKE() comparison.
236		* @param mixed $y Argument to be used in LIKE() comparison.
237		*
238		* @return string
239		*/
240	1957	public function like($x, $y/, ?string $escapeChar = null /)
241		{
242	1957	return $this->comparison($x, 'LIKE', $y) .
243	1957	(func_num_args() >= 3 ? sprintf(' ESCAPE %s', func_get_arg(2)) : '');
244		}
245
246		/**
247		* Creates a NOT LIKE() comparison expression with the given arguments.
248		*
249		* @param string $x Field in string format to be inspected by NOT LIKE() comparison.
250		* @param mixed $y Argument to be used in NOT LIKE() comparison.
251		*
252		* @return string
253		*/
254	1911	public function notLike($x, $y/, ?string $escapeChar = null /)
255		{
256	1911	return $this->comparison($x, 'NOT LIKE', $y) .
257	1911	(func_num_args() >= 3 ? sprintf(' ESCAPE %s', func_get_arg(2)) : '');
258		}
259
260		/**
261		* Creates a IN () comparison expression with the given arguments.
262		*
263		* @param string $x The field in string format to be inspected by IN() comparison.
264		* @param string\|string[] $y The placeholder or the array of values to be used by IN() comparison.
265		*
266		* @return string
267		*/
268	1980	public function in($x, $y)
269		{
270	1980	return $this->comparison($x, 'IN', '(' . implode(', ', (array) $y) . ')');
271		}
272
273		/**
274		* Creates a NOT IN () comparison expression with the given arguments.
275		*
276		* @param string $x The field in string format to be inspected by NOT IN() comparison.
277		* @param string\|string[] $y The placeholder or the array of values to be used by NOT IN() comparison.
278		*
279		* @return string
280		*/
281	2	public function notIn($x, $y)
282		{
283	2	return $this->comparison($x, 'NOT IN', '(' . implode(', ', (array) $y) . ')');
284		}
285
286		/**
287		* Quotes a given input parameter.
288		*
289		* @param mixed $input The parameter to be quoted.
290		* @param int\|null $type The type of the parameter.
291		*
292		* @return string
293		*/
294		public function literal($input, $type = null)
295		{
296		return $this->connection->quote($input, $type);
297		}
298		}
299

doctrine / dbal

Push — 2.10.x ( 61a6b9...f20ba1 )

ExpressionBuilder::lt() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like