<?php

namespace Dash;

/**

* Gets a new array of the return values of `$iteratee` when called with successive elements in `$iterable`.

*

* Unlike `map()`, keys in `$iterable` are preserved.

*

* @see map(), mapResult()

*

* @param iterable|stdClass|null $iterable

* @param callable|string|integer $iteratee (optional) If a callable, invoked with `($value, $key, $iterable)`

* for each element in `$iterable`;

* if a string or integer, will use `Dash\property($iteratee)` as the iteratee

* @return array A new array with the same keys as `$iterable`

*

* @example

Dash\mapValues(['a' => 1, 'b' => 2, 'c' => 3], function ($value) {

return $value * 2;

});

// === ['a' => 2, 'b' => 4, 'c' => 6]

*

* @example With a path `$iteratee`

$data = [

'jdoe' => ['name' => ['first' => 'John', 'last' => 'Doe']],

'mjane' => ['name' => ['first' => 'Mary', 'last' => 'Jane']],

'psmith' => ['name' => ['first' => 'Pete', 'last' => 'Smith']],

];

Dash\mapValues($data, 'name.last');

// === ['jdoe' => 'Doe', 'mjane' => 'Jane', 'psmith' => 'Smith']

*/

function mapValues($iterable, $iteratee = 'Dash\identity')

}