34 lines
1.2 KiB
JavaScript
34 lines
1.2 KiB
JavaScript
|
//#region src/map/findValue.ts
|
||
|
|
/**
|
||
|
|
* Finds the first value in a Map for which the predicate function returns true.
|
||
|
|
*
|
||
|
|
* This function iterates through the entries of the Map and returns the value of the first
|
||
|
|
* entry for which the predicate function returns true. If no entry satisfies the predicate,
|
||
|
|
* it returns undefined.
|
||
|
|
*
|
||
|
|
* @template K - The type of keys in the Map.
|
||
|
|
* @template V - The type of values in the Map.
|
||
|
|
* @param {Map<K, V>} map - The Map to search.
|
||
|
|
* @param {(value: V, key: K, map: Map<K, V>) => boolean} doesMatch - A predicate function that tests each entry.
|
||
|
|
* @returns {V | undefined} The value of the first entry that satisfies the predicate, or undefined if none found.
|
||
|
|
*
|
||
|
|
* @example
|
||
|
|
* const map = new Map([
|
||
|
|
* ['apple', { color: 'red', quantity: 10 }],
|
||
|
|
* ['banana', { color: 'yellow', quantity: 5 }],
|
||
|
|
* ['grape', { color: 'purple', quantity: 15 }]
|
||
|
|
* ]);
|
||
|
|
* const result = findValue(map, (value) => value.quantity > 10);
|
||
|
|
* // result will be: { color: 'purple', quantity: 15 }
|
||
|
|
*/
|
||
|
|
function findValue(map, doesMatch) {
|
||
|
|
let result = void 0;
|
||
|
|
for (const [key, value] of map) if (doesMatch(value, key, map)) {
|
||
|
|
result = value;
|
||
|
|
break;
|
||
|
|
}
|
||
|
|
return result;
|
||
|
|
}
|
||
|
|
//#endregion
|
||
|
|
exports.findValue = findValue;
|