Function findFirstValue

Find the first value which matches a predicate.

Returns

The first matching value, or undefined if no matching value is found.

Notes

If stop < start the search will wrap at the end of the array.

Complexity

Linear.

Undefined Behavior

A start or stop which is non-integral.

Modifying the length of the array while searching.

Example

import { ArrayExt } from '@lumino/algorithm';

function isEven(value: number): boolean {
  return value % 2 === 0;
}

let data = [1, 2, 3, 4, 3, 2, 1];
ArrayExt.findFirstValue(data, isEven);       // 2
ArrayExt.findFirstValue(data, isEven, 2);    // 4
ArrayExt.findFirstValue(data, isEven, 6);    // undefined
ArrayExt.findFirstValue(data, isEven, 6, 5); // 2