$_) { return $key; } return null; } /** * Get the first value of an iterable * * @param iterable $iterable * * @return mixed|null The first value of the iterable if it is not empty, null otherwise */ function iterable_value_first(iterable $iterable): mixed { foreach ($iterable as $value) { return $value; } return null; } /** * Yield sets of items from a sorted traversable grouped by a specific criterion gathered from a callback * * The traversable must be sorted by the criterion. The callback must return at least the criterion, * but can also return value and key in addition. * * @param Traversable $traversable * @param callable(mixed $value, mixed $key): array{0: mixed, 1?: mixed, 2?: mixed} $groupBy * * @return Generator */ function yield_groups(Traversable $traversable, callable $groupBy): Generator { $iterator = new IteratorIterator($traversable); $iterator->rewind(); if (! $iterator->valid()) { return; } [$criterion, $v, $k] = array_pad((array) $groupBy($iterator->current(), $iterator->key()), 3, null); $group = [$k ?? $iterator->key() => $v ?? $iterator->current()]; $iterator->next(); for (; $iterator->valid(); $iterator->next()) { [$c, $v, $k] = array_pad((array) $groupBy($iterator->current(), $iterator->key()), 3, null); if ($c !== $criterion) { yield $criterion => $group; $group = []; $criterion = $c; } $group[$k ?? $iterator->key()] = $v ?? $iterator->current(); } yield $criterion => $group; }