WireArray::findOne() method

Find a single item by selector

This is the same as WireArray::find() except that it returns a single item rather than a new WireArray of items.

Example

// Get an item with name "foo-bar"
$item = $items->findOne("name=foo-bar");
if($item) {
  // item was found
} else {
  // item was not found
}

Usage

$wire = $wireArray->findOne($selector);

Arguments

NameType(s)Description
selectorstring, array, Selectors

Return value

Wire bool

Returns item from WireArray or false if the result is empty.

See Also


WireArray methods and properties

API reference based on ProcessWire core version 3.0.248

Latest news

  • ProcessWire Weekly #582
    The 582nd issue of ProcessWire Weekly brings in all the latest news from the ProcessWire community. Modules, sites, and more. Read on!
    Weekly.pw / 5 July 2025
  • New ProcessWire admin redesign
    When you upgrade to ProcessWire 3.0.248 or newer (currently the dev branch), you’ll immediately notice something new and beautiful…
    Blog / 9 May 2025
  • Subscribe to weekly ProcessWire 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