Function group

group<T, K>(
keyOfValue: (value: T) => K,
): (values: Iterable<T>) => MapIterator<[K, T[]]>
Creates a function that groups elements from an iterable based on keys generated by a mapping function.
Type Parameters
- T
  The type of elements in the input iterable
- K
  The type of keys used for grouping
Parameters
- keyOfValue: (value: T) => K
  A function that extracts a key from each value
Returns (values: Iterable<T>) => MapIterator<[K, T[]]>
A function that takes an iterable and yields entries of [key, group of values]
Yields
Entries where each entry is a tuple of [key, values] with values being all elements that map to that key
Example
```
// Group numbers by even/odd
const byParity = G.group(x => x % 2 === 0 ? 'even' : 'odd');
const result = Array.from(byParity([1, 2, 3, 4, 5]));
// [['odd', [1, 3, 5]], ['even', [2, 4]]]
```
See
- groupMap - For getting a Map instead of entries iterator
- groupObject - For getting an object instead of entries iterator
- Defined in generator/src/group.ts:24