Function filterOne

filterOne<T, K = T>(
    array: T[],
    logicalSelector: PLogicalSelector<T>,
    transform?: (element: T, i: number) => K,
): K
Gets the first element in the array that matches the given logical selector.
Type Parameters
- T
  The type of elements in the array.
- K = T
  The return type of the transformation function, if provided.
Parameters
- array: T[]
  The target array to search in.
- logicalSelector: PLogicalSelector<T>
  The selector used to identify the matching element. This can be either a predicate function or an object for property-based matching.
- Optionaltransform: (element: T, i: number) => K
  A function to transform the selected element before returning it.
Returns K
The first matching element, optionally transformed.
Example
```
const pets = [
    { type: 'dog', name: 'Fido' },
    { type: 'dog', name: 'Chacalin' },
    { type: 'cat', name: 'Mr. Brown' },
    { type: 'cat', name: 'Night' },
]
console.log(PUtilsArray.queryOne(pets, pet => pet.type === 'dog'))
// => { type: 'dog', name: 'Fido' }

console.log(PUtilsArray.queryOne(pets, { type: 'dog' }))
// => { type: 'dog', name: 'Fido' }

console.log(PUtilsArray.queryOne(pets, { type: 'cat' }, pet => pet.name))
// => 'Mr. Brown'
```
- Defined in putils/array.ts:119