/**
* Sorts a collection with a user-defined function, optionally preserving array keys
*
* @param Traversable|array $collection
* @param callable $callback
* @param bool $preserveKeys
* @return array
*/
function sort($collection, callable $callback, $preserveKeys = false)
{
InvalidArgumentException::assertCollection($collection, __FUNCTION__, 1);
InvalidArgumentException::assertBoolean($preserveKeys, __FUNCTION__, 3);
if ($collection instanceof Traversable) {
$array = iterator_to_array($collection);
} else {
$array = $collection;
}
$fn = $preserveKeys ? 'uasort' : 'usort';
$fn($array, function ($left, $right) use($callback, $collection) {
return $callback($left, $right, $collection);
});
return $array;
}