Copied!

Priority

Priority.php : 24
Extends Location
Implements FilteringCriterion

A criterion that matches Location based on its priority.

Supported operators:

  • BETWEEN: matches location whose priority is between (included) the TWO given priorities
  • GT, GTE: matches location whose priority is greater than/greater than or equals the given priority
  • LT, LTE: matches location whose priority is lower than/lower than or equals the given priority

Properties

public $operator

Criterion.php : 23

The operator used by the Criterion.

public string $operator

public $target

Criterion.php : 37

The target used by the criteria (field, metadata...).

public string $target

public $value

Criterion.php : 30

The value(s) matched by the criteria.

public array<string|int, scalar>|scalar $value

public $valueData

Criterion.php : 44

Additional value data, required by some criterions, MapLocationDistance for instance.

public Value $valueData

Methods

public__construct()

Priority.php : 32

Creates a new LocationPriority criterion.

public __construct(string $operator, mixed $value)

Parameters

Name Type Default value Description
$operator string -

One of the Operator constants

$value mixed -

The match value, either as an array of as a single value, depending on the operator

publiccreateFromQueryBuilder()

Priority.php : 51
public static createFromQueryBuilder(mixed $target, mixed $operator, mixed $value) : mixed

Parameters

Name Type Default value Description
$target mixed - -
$operator mixed - -
$value mixed - -
Tags
Deprecated

since 7.2, will be removed in 8.0. Use the constructor directly instead.

publicgetSpecifications()

Priority.php : 37

Criterion description function.

public getSpecifications() : array<string|int, Specifications>

Returns the combination of the Criterion's supported operator/value, as an array of Specifications objects

  • Operator is one supported Operator, as an Operator::* constant
  • ValueType is the type of input value this operator requires, either array or single
  • SupportedTypes is an array of types the operator will accept
  • ValueCountLimitation is an integer saying how many values are expected.
// IN and EQ are supported return [ // The EQ operator expects a single value, either as an integer or a string new Specifications( Operator::EQ, Specifications::FORMAT_SINGLE, Specifications::TYPE_INTEGER | Specifications::TYPE_STRING ), // The IN operator expects an array of values, of either integers or strings new Specifications( Operator::IN, Specifications::FORMAT_ARRAY, Specifications::TYPE_INTEGER | Specifications::TYPE_STRING ) ]

Return values

array<string|int, Specifications>