Selectors::selectorHasField() method

Does given selector have given field (and optionally operator and/or value)?

Available since version 3.0.174.

Usage

// basic usage
$array = Selectors::selectorHasField($selectors, $fieldName);

// usage with all arguments
$array = Selectors::selectorHasField($selectors, $fieldName, array $options = []);

Arguments

NameType(s)Description
selectorsstring, array, Selectors

Selector string, array or Selectors object to look in

fieldNamestring, array

Field name string to match or array of them to match any one of them

options (optional)array
  • verbose (bool): Return associative array with verbose result? See return value. (default=false)
  • operator (string): Require this operator (default='' for any)
  • value (string|int): Require this value (default=null for any)
  • remove (bool): Remove matched Selector from Selectors returned in verbose result? (default=false)

Return value

array bool

True if has field, false if not, or array with the following, if 'verbose' option requested:

  • result (bool): Did it match (true or false)
  • selector (Selector|null): Selector object that matched (only if result is true)
  • selectors (Selectors|null): Selectors object that was analyzed or null if not needed
  • field (string): Field name that matched
  • operator (string): Operator that matched
  • value (string|null): Value that matched or null if not applicable

Selectors methods and properties

API reference based on ProcessWire core version 3.0.248

Latest news

“ProcessWire is like a breath of fresh air. So powerful yet simple to build with and customise, and web editors love it too.” —Margaret Chatwin, Web developer