map

遍历集合并将每一个值传入给定的回调。

该回调可以任意修改项目并返回，从而形成新的被修改过项目的集合。

collect([1, 2, 3, 4])->map(fn ($item) => $item * 10); // [10, 20, 30, 40]

像其他集合方法一样，map 返回一个新集合实例；它不会修改它所调用的集合。如果想改变原集合，得使用 transform 方法。

它与 reduce 的区别是 reduce 传入集合或数组，返回的是单一值；而map()传入数组或集合，返回的依然是集合。

返回字符串

改变返回集合中 value 的值，不改变 key 的内容。

collect(['value1' => 'first', 'value2' => 'second'])
    ->map(fn ($item,$key) => $item . '_' . $key);

// ["value1" => "first_value1", "value2" => "second_value2"]

返回数组

改变返回集合中value的值，不改变key的内容。

collect(['value1' => 'first', 'value2' => 'second'])
    ->map(fn ($item, $key) => [$item . '_' . $key]);

/*
[
    "value1" => ["first_value1"],
    "value2" => ["second_value2"]
]
*/

返回null

如果回调中没有任何返回语句，默认返回 null。

collect(['value1' => 'first', 'value2' => 'second'])
    ->map(fn ($item, $key) => null);

// ["value1" => null, "value2" => null]

返回空数组

collect(['value1' => 'first', 'value2' => 'second'])
    ->map(fn ($item, $key) => []);

// ["value1" => [], "value2" => []]

不改变原集合

$collection = collect([1, 2, 3, 4]);

$newCollection = $collection->map(fn ($item) => $item * 10);

$newCollection; // [10, 20, 30, 40]
$collection; // [1, 2, 3, 4]

相关方法

• transform
• reduce