Метод prepend
Метод prepend применяется к коллекции и добавляет переданное значение в её начало. Первым параметром передаётся значение, которое нужно добавить, вторым (необязательным) - ключ, под которым элемент будет сохранён. Если ключ не указан, элемент добавляется с числовым индексом 0, а все остальные элементы сдвигаются на одну позицию вправо. Метод возвращает модифицированную коллекцию.
Синтаксис
<?php
$collection->prepend($value, $key);
?>
Пример
Давайте добавим элемент в начало коллекции без указания ключа:
<?php
use Illuminate\Support\Collection;
$collection = new Collection(['a', 'b', 'c']);
$res = $collection->prepend('x');
print_r($res->all());
?>
Результат выполнения кода:
["x", "a", "b", "c"]
Пример
Давайте добавим элемент в начало коллекции с указанием ключа:
<?php
use Illuminate\Support\Collection;
$collection = new Collection(['a', 'b', 'c']);
$res = $collection->prepend('x', 'new_key');
print_r($res->all());
?>
Результат выполнения кода:
["new_key" => "x", 0 => "a", 1 => "b", 2 => "c"]
Пример
Давайте добавим несколько элементов в начало коллекции последовательно:
<?php
use Illuminate\Support\Collection;
$collection = new Collection(['a', 'b', 'c']);
$res = $collection
->prepend('x')
->prepend('y')
->prepend('z');
print_r($res->all());
?>
Результат выполнения кода:
["z", "y", "x", "a", "b", "c"]
Пример
Давайте добавим элемент в начало коллекции с существующим ключом - старый элемент будет заменён:
<?php
use Illuminate\Support\Collection;
$collection = new Collection(['a', 'b', 'c']);
$res = $collection->prepend('x', 1);
print_r($res->all());
?>
Результат выполнения кода:
[1 => "x", 0 => "a", 2 => "c"]
