[null, null], default => [$result, $needle] }; } if (! $caseSensitive && is_string($needle) && ! $usesCallback) { $needle = strtolower($needle); } foreach ($traversable as $key => $item) { $originalItem = $item; if (! $caseSensitive && is_string($item)) { $item = strtolower($item); } if ($usesCallback) { /** @var Closure $needle */ if ($needle($item)) { return [$key, $originalItem]; } } elseif ($item === $needle) { return [$key, $originalItem]; } } return [null, null]; } /** * Search in the traversable for the given needle and return its key * * @param iterable $traversable * @param mixed $needle Might also be a closure * @param bool $caseSensitive Whether strings should be compared case-sensitive * * @return mixed|null Null if nothing is found */ public static function findKey(iterable $traversable, mixed $needle, bool $caseSensitive = true): mixed { return self::find($traversable, $needle, $caseSensitive)[0]; } /** * Search in the traversable for the given needle and return its value * * @param iterable $traversable * @param mixed $needle Might also be a closure * @param bool $caseSensitive Whether strings should be compared case-sensitive * * @return mixed|null Null if nothing is found */ public static function findValue(iterable $traversable, mixed $needle, bool $caseSensitive = true): mixed { $usesCallback = $needle instanceof Closure; if (! $usesCallback && $caseSensitive && is_array($traversable)) { return $traversable[$needle] ?? null; } if (! $caseSensitive && is_string($needle) && ! $usesCallback) { $needle = strtolower($needle); } foreach ($traversable as $key => $item) { if (! $caseSensitive && is_string($key)) { $key = strtolower($key); } if ($usesCallback) { /** @var Closure $needle */ if ($needle($key)) { return $item; } } elseif ($key === $needle) { return $item; } } return null; } /** * Apply the callback to all elements of the given traversable, while preserving keys * * @param iterable $traversable * @param callable $callback * * @return Generator */ public static function map(iterable $traversable, callable $callback): Generator { foreach ($traversable as $key => $value) { yield $key => $callback($value); } } /** * Yield every unique value of the given traversable with its original key * * Values are compared type-sensitively. Objects are compared by instance * identity. Arrays are compared using strict equality, so the same key/value pairs * in a different order are treated as different values. Case-insensitive * comparison applies only to direct string values, not to strings nested * inside arrays. * * @param iterable $traversable * @param bool $caseSensitive * * @return Generator */ public static function unique(iterable $traversable, bool $caseSensitive = true): Generator { $seenObjects = new SplObjectStorage(); $seenValues = []; foreach ($traversable as $key => $value) { if (is_object($value)) { if ($seenObjects->offsetExists($value)) { continue; } $seenObjects->offsetSet($value); yield $key => $value; continue; } $seenValue = ! $caseSensitive && is_string($value) ? strtolower($value) : $value; if (in_array($seenValue, $seenValues, true)) { continue; } $seenValues[] = $seenValue; yield $key => $value; } } }