Spec-Zone.ru › Laravel 6

Коллекция

класс Collection реализует ArrayAccess, Enumerable (Просмотреть исходный код)

Трейты

EnumeratesValues
Macroable

Свойства

static protected array $proxies

Методы, которые могут быть проксированы.

из EnumeratesValues
HigherOrderCollectionProxy только для чтения $average из EnumeratesValues
HigherOrderCollectionProxy только для чтения $avg из EnumeratesValues
HigherOrderCollectionProxy только для чтения $contains из EnumeratesValues
HigherOrderCollectionProxy только для чтения $each из EnumeratesValues
HigherOrderCollectionProxy только для чтения $every из EnumeratesValues
HigherOrderCollectionProxy только для чтения $filter из EnumeratesValues
HigherOrderCollectionProxy только для чтения $first из EnumeratesValues
HigherOrderCollectionProxy только для чтения $flatMap из EnumeratesValues
HigherOrderCollectionProxy только для чтения $groupBy из EnumeratesValues
HigherOrderCollectionProxy только для чтения $keyBy из EnumeratesValues
HigherOrderCollectionProxy только для чтения $map из EnumeratesValues
HigherOrderCollectionProxy только для чтения $max из EnumeratesValues
HigherOrderCollectionProxy только для чтения $min из EnumeratesValues
HigherOrderCollectionProxy только для чтения $partition из EnumeratesValues
HigherOrderCollectionProxy только для чтения $reject из EnumeratesValues
HigherOrderCollectionProxy только для чтения $sortBy из EnumeratesValues
HigherOrderCollectionProxy только для чтения $sortByDesc из EnumeratesValues
HigherOrderCollectionProxy только для чтения $sum из EnumeratesValues
HigherOrderCollectionProxy только для чтения $unique из EnumeratesValues
static protected array $macros

Зарегистрированные строковые макросы.

из Macroable
protected array $items

Элементы, содержащиеся в коллекции.

Методы

static EnumeratesValues make(mixed $items = [])

Создать новый экземпляр коллекции, если значение не является коллекцией.

from EnumeratesValues
static EnumeratesValues wrap(mixed $value)

Оборачивает заданное значение в коллекцию, если применимо.

from EnumeratesValues
static array unwrap(array|EnumeratesValues $value)

Получить базовые элементы из заданной коллекции, если применимо.

from EnumeratesValues
mixed average(callable|string|null $callback = null)

Псевдоним для метода "avg".

from EnumeratesValues
bool some(mixed $key, mixed $operator = null, mixed $value = null)

Псевдоним для метода "contains".

from EnumeratesValues
bool containsStrict(mixed $key, mixed $value = null)

Определить, существует ли элемент, используя строгое сравнение.

from EnumeratesValues
void dd(mixed ...$args)

Вывести элементы и завершить сценарий.

from EnumeratesValues
$this dump()

Вывести элементы.

from EnumeratesValues
$this each(callable $callback)

Выполнить обратный вызов над каждым элементом.

from EnumeratesValues
EnumeratesValues eachSpread(callable $callback)

Выполнить обратный вызов над каждым вложенным набором элементов.

from EnumeratesValues
bool every(string|callable $key, mixed $operator = null, mixed $value = null)

Определить, проходят ли все элементы заданный логический тест.

from EnumeratesValues
mixed firstWhere(string $key, mixed $operator = null, mixed $value = null)

Получить первый элемент по заданной паре ключ-значение.

from EnumeratesValues
bool isNotEmpty()

Определить, не пуста ли коллекция.

from EnumeratesValues
EnumeratesValues mapSpread(callable $callback)

Применить отображение к каждому вложенному набору элементов.

from EnumeratesValues
EnumeratesValues mapToGroups(callable $callback)

Выполнить групповое отображение над элементами.

from EnumeratesValues
EnumeratesValues flatMap(callable $callback)

Применить отображение к коллекции и сгладить результат на один уровень.

from EnumeratesValues
EnumeratesValues mapInto(string $class)

Применить отображение значений в новый класс.

from EnumeratesValues
mixed min(callable|string|null $callback = null)

Получить минимальное значение заданного ключа.

from EnumeratesValues
mixed max(callable|string|null $callback = null)

Получить максимальное значение заданного ключа.

from EnumeratesValues
EnumeratesValues forPage(int $page, int $perPage)

«Разбить» коллекцию, разделив её на более мелкие коллекции.

from EnumeratesValues
EnumeratesValues partition(callable|string $key, mixed $operator = null, mixed $value = null)

Разделить коллекцию на два массива, используя заданный обратный вызов или ключ.

from EnumeratesValues
mixed sum(callable|string|null $callback = null)

Получить сумму заданных значений.

from EnumeratesValues
EnumeratesValues|mixed when(bool|mixed $value, callable $callback, callable $default = null)

Применить обратный вызов, если значение истинно.

from EnumeratesValues
EnumeratesValues|mixed whenEmpty(callable $callback, callable $default = null)

Применить обратный вызов, если коллекция пуста.

from EnumeratesValues
EnumeratesValues|mixed whenNotEmpty(callable $callback, callable $default = null)

Применить обратный вызов, если коллекция не пуста.

from EnumeratesValues
EnumeratesValues|mixed unless(bool $value, callable $callback, callable $default = null)

Применить обратный вызов, если значение ложно.

from EnumeratesValues
EnumeratesValues|mixed unlessEmpty(callable $callback, callable $default = null)

Применить обратный вызов, если коллекция не пуста.

from EnumeratesValues
EnumeratesValues|mixed unlessNotEmpty(callable $callback, callable $default = null)

Применить обратный вызов, если коллекция не пуста.

from EnumeratesValues
EnumeratesValues where(string $key, mixed $operator = null, mixed $value = null)

Фильтровать элементы по заданной паре ключ-значение.

from EnumeratesValues
EnumeratesValues whereNull(string|null $key = null)

Фильтровать элементы, где заданный ключ не равен null.

from EnumeratesValues
EnumeratesValues whereNotNull(string|null $key = null)

Фильтровать элементы, где заданный ключ равен null.

from EnumeratesValues
EnumeratesValues whereStrict(string $key, mixed $value)

Фильтровать элементы по заданной паре ключ-значение с использованием строгого сравнения.

from EnumeratesValues
EnumeratesValues whereIn(string $key, mixed $values, bool $strict = false)

Фильтровать элементы по заданной паре ключ-значение.

from EnumeratesValues
EnumeratesValues whereInStrict(string $key, mixed $values)

Фильтровать элементы по заданной паре ключ-значение с использованием строгого сравнения.

from EnumeratesValues
EnumeratesValues whereBetween(string $key, array $values)

Фильтровать элементы, где значение заданного ключа находится между заданными значениями.

from EnumeratesValues
EnumeratesValues whereNotBetween(string $key, array $values)

Фильтровать элементы, где значение заданного ключа не находится между заданными значениями.

from EnumeratesValues
EnumeratesValues whereNotIn(string $key, mixed $values, bool $strict = false)

Фильтровать элементы по заданной паре ключ-значение.

from EnumeratesValues
EnumeratesValues whereNotInStrict(string $key, mixed $values)

Фильтровать элементы по заданной паре ключ-значение с использованием строгого сравнения.

from EnumeratesValues
EnumeratesValues whereInstanceOf(string $type)

Фильтровать элементы, удаляя те, которые не соответствуют заданному типу.

from EnumeratesValues
mixed pipe(callable $callback)

Передать коллекцию в заданный обратный вызов и вернуть результат.

from EnumeratesValues
$this tap(callable $callback)

Передать коллекцию в заданный обратный вызов и затем вернуть её.

from EnumeratesValues
EnumeratesValues reject(callable|mixed $callback = true)

Создать коллекцию всех элементов, которые не проходят заданный тест истинности.

from EnumeratesValues
EnumeratesValues unique(string|callable|null $key = null, bool $strict = false)

Возвратить только уникальные элементы из массива коллекции.

from EnumeratesValues
EnumeratesValues uniqueStrict(string|callable|null $key = null)

Возвратить только уникальные элементы из массива коллекции с использованием строгого сравнения.

from EnumeratesValues
Collection collect()

Собрать значения в коллекцию.

from EnumeratesValues
array toArray()

Получить коллекцию элементов как обычный массив.

from EnumeratesValues
array jsonSerialize()

Преобразовать объект в нечто сериализуемое в JSON.

from EnumeratesValues
string toJson(int $options = 0)

Получить коллекцию элементов в формате JSON.

from EnumeratesValues
CachingIterator getCachingIterator(int $flags = CachingIterator::CALL_TOSTRING)

Получить экземпляр CachingIterator.

from EnumeratesValues
EnumeratesValues countBy(callable|null $callback = null)

Подсчитать количество элементов в коллекции с помощью заданного теста истинности.

from EnumeratesValues
string __toString()

Преобразовать коллекцию в её строковое представление.

from EnumeratesValues
static void proxy(string $method)

Добавить метод в список прокси-методов.

from EnumeratesValues
mixed __get(string $key)

Динамичный доступ к коллекциям-прокси.

из EnumeratesValues
array getArrayableItems(mixed $items)

Массив результатов элементов из коллекции или Arrayable.

из EnumeratesValues
Closure operatorForWhere(string $key, string|null $operator = null, mixed $value = null)

Получить обратный вызов для проверки оператора.

из EnumeratesValues
bool useAsCallable(mixed $value)

Определить, является ли заданное значение вызываемым, но не строкой.

из EnumeratesValues
callable valueRetriever(callable|string|null $value)

Получить обратный вызов для извлечения значения.

из EnumeratesValues
static void macro(string $name, object|callable $macro)

Регистрация пользовательского макроса.

из Macroable
static void mixin(object $mixin, bool $replace = true)

Смешивание другого объекта в класс.

из Macroable
static bool hasMacro(string $name)

Проверка наличия зарегистрированного макроса.

из Macroable
static mixed __callStatic(string $method, array $parameters)

Динамическая обработка вызовов класса.

из Macroable
mixed __call(string $method, array $parameters)

Динамическая обработка вызовов класса.

из Macroable
void __construct(mixed $items = [])

Создание новой коллекции.

static Enumerable times(int $number, callable $callback = null)

Создание новой коллекции, вызывая обратный вызов заданное количество раз.

array all()

Получение всех элементов коллекции.

LazyCollection lazy()

Получение ленивой коллекции для элементов этой коллекции.

mixed avg(callable|string|null $callback = null)

Получение среднего значения заданного ключа.

mixed median(string|array|null $key = null)

Получение медианы заданного ключа.

array|null mode(string|array|null $key = null)

Получение моды заданного ключа.

Enumerable collapse()

Сжатие элементов коллекции в один массив.

bool contains(mixed $key, mixed $operator = null, mixed $value = null)

Определение наличия элемента в коллекции.

Collection crossJoin(mixed ...$lists)

Перекрестное объединение с заданными списками, возвращающее все возможные перестановки.

Enumerable diff(mixed $items)

Получение элементов коллекции, отсутствующих в заданных элементах.

Enumerable diffUsing(mixed $items, callable $callback)

Получение элементов коллекции, отсутствующих в заданных элементах, используя обратный вызов.

Enumerable diffAssoc(mixed $items)

Получение элементов коллекции, у которых ключи и значения отсутствуют в заданных элементах.

Enumerable diffAssocUsing(mixed $items, callable $callback)

Получение элементов коллекции, у которых ключи и значения отсутствуют в заданных элементах, используя обратный вызов.

Enumerable diffKeys(mixed $items)

Получение элементов коллекции, у которых ключи отсутствуют в заданных элементах.

Enumerable diffKeysUsing(mixed $items, callable $callback)

Получение элементов коллекции, у которых ключи отсутствуют в заданных элементах, используя обратный вызов.

Enumerable duplicates(callable|null $callback = null, bool $strict = false)

Получение дублирующихся элементов из коллекции.

Enumerable duplicatesStrict(callable|null $callback = null)

Получение дублирующихся элементов из коллекции с использованием строгого сравнения.

Closure duplicateComparator(bool $strict)

Получение функции сравнения для обнаружения дубликатов.

Enumerable except(mixed $keys)

Получение всех элементов, кроме тех, у которых указаны ключи.

Enumerable filter(callable $callback = null)

Применение фильтра к каждому элементу.

mixed first(callable $callback = null, mixed $default = null)

Получение первого элемента, удовлетворяющего заданному условию.

Collection flatten(int $depth = INF)

Получение сглаженного массива элементов коллекции.

Enumerable flip()

Переворот элементов в коллекции.

$this forget(string|array $keys)

Удаление элемента из коллекции по ключу.

mixed get(mixed $key, mixed $default = null)

Получение элемента из коллекции по ключу.

Enumerable groupBy(array|callable|string $groupBy, bool $preserveKeys = false)

Группировка ассоциативного массива по полю или с помощью обратного вызова.

Перечисляемый keyBy(callable|string $keyBy)

Ключевой ассоциативный массив по полю или с помощью обратного вызова.

bool has(mixed $key)

Определить, существует ли элемент в коллекции по ключу.

string implode(string $value, string $glue = null)

Объединить значения заданного ключа в строку.

Перечисляемый intersect(mixed $items)

Пересечь коллекцию с заданными элементами.

Перечисляемый intersectByKeys(mixed $items)

Пересечь коллекцию с заданными элементами по ключу.

bool isEmpty()

Определить, пуста ли коллекция.

string join(string $glue, string $finalGlue = '')

Объединить все элементы из коллекции с помощью строки. Для последних элементов можно использовать отдельную строку разделителя.

Перечисляемый keys()

Получить ключи элементов коллекции.

mixed last(callable $callback = null, mixed $default = null)

Получить последний элемент из коллекции.

Перечисляемый pluck(string|array $value, string|null $key = null)

Получить значения заданного ключа.

Перечисляемый map(callable $callback)

Применить отображение к каждому из элементов.

Перечисляемый mapToDictionary(callable $callback)

Применить отображение словаря к элементам.

Перечисляемый mapWithKeys(callable $callback)

Применить ассоциативное отображение к каждому из элементов.

Перечисляемый merge(mixed $items)

Объединить коллекцию с заданными элементами.

Перечисляемый mergeRecursive(mixed $items)

Рекурсивно объединить коллекцию с заданными элементами.

Перечисляемый combine(mixed $values)

Создать коллекцию, используя эту коллекцию для ключей и другую для значений.

Перечисляемый union(mixed $items)

Объединить коллекцию с заданными элементами.

Перечисляемый nth(int $step, int $offset = 0)

Создать новую коллекцию, состоящую из каждого n-го элемента.

Перечисляемый only(mixed $keys)

Получить элементы со значениями указанных ключей.

mixed pop()

Получить и удалить последний элемент из коллекции.

$this prepend(mixed $value, mixed $key = null)

Добавить элемент в начало коллекции.

$this push(mixed $value)

Добавить элемент в конец коллекции.

Перечисляемый concat(iterable $source)

Добавить все заданные элементы в коллекцию.

mixed pull(mixed $key, mixed $default = null)

Получить и удалить элемент из коллекции.

$this put(mixed $key, mixed $value)

Поместить элемент в коллекцию по ключу.

Перечисляемый|mixed random(int|null $number = null)

Случайным образом получить один или заданное количество элементов из коллекции.

mixed reduce(callable $callback, mixed $initial = null)

Свести коллекцию к одному значению.

Перечисляемый replace(mixed $items)

Заменить элементы коллекции заданными элементами.

Перечисляемый replaceRecursive(mixed $items)

Рекурсивно заменить элементы коллекции заданными элементами.

Перечисляемый reverse()

Перевернуть порядок элементов.

mixed search(mixed $value, bool $strict = false)

Найти в коллекции заданное значение и вернуть соответствующий ключ, если поиск успешен.

mixed shift()

Получить и удалить первый элемент из коллекции.

Перечисляемый shuffle(int $seed = null)

Перемешать элементы в коллекции.

Перечисляемый skip(int $count)

Пропустить первые {$count} элементов.

Перечисляемый slice(int $offset, int $length = null)

Выделить часть массива лежащего в основе коллекции.

Перечисляемый split(int $numberOfGroups)

Разделить коллекцию на определенное количество групп.

Перечисляемый chunk(int $size)

Разбить коллекцию на части заданного размера.

Перечисляемый sort(callable $callback = null)

Отсортировать каждый элемент с помощью обратного вызова.

Перечисляемый sortBy(callable|string $callback, int $options = SORT_REGULAR, bool $descending = false)

Отсортировать коллекцию с использованием заданного обратного вызова.

Перечисляемый sortByDesc(callable|string $callback, int $options = SORT_REGULAR)

Отсортировать коллекцию в обратном порядке с использованием заданного обратного вызова.

Перечисляемый sortKeys(int $options = SORT_REGULAR, bool $descending = false)

Отсортировать ключи коллекции.

Перечисляемый sortKeysDesc(int $options = SORT_REGULAR)

Отсортировать ключи коллекции в обратном порядке.

Коллекция splice(int $offset, int|null $length = null, mixed $replacement = [])

Разделить часть массива базовой коллекции.

Перечислимый take(int $limit)

Взять первые или последние {$limit} элементов.

$this transform(callable $callback)

Преобразовать каждый элемент в коллекции с помощью обратного вызова.

Перечислимый values()

Сбросить ключи в базовом массиве.

Коллекция zip(mixed $items)

Объединить коллекцию с одним или несколькими массивами.

Перечислимый pad(int $size, mixed $value)

Заполнить коллекцию до указанной длины значением.

ArrayIterator getIterator()

Получить итератор для элементов.

int count()

Подсчитать количество элементов в коллекции.

$this add(mixed $item)

Добавить элемент в коллекцию.

Коллекция toBase()

Получить базовый экземпляр коллекции Support из этой коллекции.

bool offsetExists(mixed $key)

Определить, существует ли элемент по указанному смещению.

mixed offsetGet(mixed $key)

Получить элемент по заданному смещению.

void offsetSet(mixed $key, mixed $value)

Установить элемент по заданному смещению.

void offsetUnset(string $key)

Удалить элемент по заданному смещению.

Подробности

static EnumeratesValues make(mixed $items = [])

Создать новый экземпляр коллекции, если значение не является коллекцией.

Parameters

mixed $items

Return Value

EnumeratesValues

static EnumeratesValues wrap(mixed $value)

Оборачивает данное значение в коллекцию, если это возможно.

Parameters

mixed $value

Return Value

EnumeratesValues

static array unwrap(array|EnumeratesValues $value)

Получить базовые элементы из данной коллекции, если это возможно.

Parameters

array|EnumeratesValues $value

Return Value

array

mixed average(callable|string|null $callback = null)

Псевдоним для метода "avg".

Parameters

callable|string|null $callback

Return Value

mixed

bool some(mixed $key, mixed $operator = null, mixed $value = null)

Псевдоним для метода "contains".

Parameters

mixed $key
mixed $operator
mixed $value

Return Value

bool

bool containsStrict(mixed $key, mixed $value = null)

Определить, существует ли элемент, используя строгое сравнение.

Parameters

mixed $key
mixed $value

Return Value

bool

void dd(mixed ...$args)

Вывести элементы и завершить выполнение скрипта.

Parameters

mixed ...$args

Return Value

void

$this dump()

Вывести элементы.

Return Value

$this

$this each(callable $callback)

Выполнить обратный вызов для каждого элемента.

Parameters

callable $callback

Return Value

$this

EnumeratesValues eachSpread(callable $callback)

Выполнить обратный вызов для каждого вложенного фрагмента элементов.

Parameters

callable $callback

Return Value

EnumeratesValues

bool every(string|callable $key, mixed $operator = null, mixed $value = null)

Определить, проходят ли все элементы заданную проверку истинности.

Parameters

string|callable $key
mixed $operator
mixed $value

Return Value

bool

mixed firstWhere(string $key, mixed $operator = null, mixed $value = null)

Получить первый элемент по заданной паре ключ-значение.

Parameters

string $key
mixed $operator
mixed $value

Return Value

mixed

bool isNotEmpty()

Определить, не пустая ли коллекция.

Return Value

bool

EnumeratesValues mapSpread(callable $callback)

Применить отображение к каждому вложенному фрагменту элементов.

Parameters

callable $callback

Return Value

EnumeratesValues
END_OF_DOCUMENT_MARKER

EnumeratesValues mapToGroups(callable $callback)

Выполнить групповую обработку элементов.

Обратный вызов должен возвращать ассоциативный массив с единственной парой ключ/значение.

Параметры

callable $callback

Возвращаемое значение

EnumeratesValues

EnumeratesValues flatMap(callable $callback)

Преобразовать коллекцию и уплостить результат на один уровень.

Параметры

callable $callback

Возвращаемое значение

EnumeratesValues

EnumeratesValues mapInto(string $class)

Преобразовать значения в новый класс.

Параметры

string $class

Возвращаемое значение

EnumeratesValues

mixed min(callable|string|null $callback = null)

Получить минимальное значение по заданному ключу.

Параметры

callable|string|null $callback

Возвращаемое значение

mixed

mixed max(callable|string|null $callback = null)

Получить максимальное значение по заданному ключу.

Параметры

callable|string|null $callback

Возвращаемое значение

mixed

EnumeratesValues forPage(int $page, int $perPage)

«Разбить» коллекцию на страницы, разделив её на меньшие коллекции.

Параметры

int $page
int $perPage

Возвращаемое значение

EnumeratesValues

EnumeratesValues partition(callable|string $key, mixed $operator = null, mixed $value = null)

Разбить коллекцию на два массива, используя заданный обратный вызов или ключ.

Параметры

callable|string $key
mixed $operator
mixed $value

Возвращаемое значение

EnumeratesValues

mixed sum(callable|string|null $callback = null)

Получить сумму заданных значений.

Параметры

callable|string|null $callback

Возвращаемое значение

mixed

EnumeratesValues|mixed when(bool|mixed $value, callable $callback, callable $default = null)

Применить обратный вызов, если значение истинно.

Параметры

bool|mixed $value
callable $callback
callable $default

Возвращаемое значение

EnumeratesValues|mixed

EnumeratesValues|mixed whenEmpty(callable $callback, callable $default = null)

Применить обратный вызов, если коллекция пуста.

Параметры

callable $callback
callable $default

Возвращаемое значение

EnumeratesValues|mixed

EnumeratesValues|mixed whenNotEmpty(callable $callback, callable $default = null)

Применить обратный вызов, если коллекция не пуста.

Параметры

callable $callback
callable $default

Возвращаемое значение

EnumeratesValues|mixed

EnumeratesValues|mixed unless(bool $value, callable $callback, callable $default = null)

Применить обратный вызов, если значение ложно.

Параметры

bool $value
callable $callback
callable $default

Возвращаемое значение

EnumeratesValues|mixed

EnumeratesValues|mixed unlessEmpty(callable $callback, callable $default = null)

Применить обратный вызов, если коллекция не пуста.

Параметры

callable $callback
callable $default

Возвращаемое значение

EnumeratesValues|mixed

EnumeratesValues|mixed unlessNotEmpty(callable $callback, callable $default = null)

Применить обратный вызов, если коллекция пуста.

Параметры

callable $callback
callable $default

Возвращаемое значение

EnumeratesValues|mixed

EnumeratesValues where(string $key, mixed $operator = null, mixed $value = null)

Фильтрует элементы по заданной паре ключ-значение.

Параметры

string $key
mixed $operator
mixed $value

Возвращаемое значение

EnumeratesValues

EnumeratesValues whereNull(string|null $key = null)

Фильтрует элементы, где заданный ключ не равен null.

Параметры

string|null $key

Возвращаемое значение

EnumeratesValues

EnumeratesValues whereNotNull(string|null $key = null)

Фильтровать элементы, где заданный ключ равен null.

Parameters

string|null $key

Return Value

EnumeratesValues

EnumeratesValues whereStrict(string $key, mixed $value)

Фильтровать элементы по заданной паре ключ-значение с использованием строгого сравнения.

Parameters

string $key
mixed $value

Return Value

EnumeratesValues

EnumeratesValues whereIn(string $key, mixed $values, bool $strict = false)

Фильтровать элементы по заданной паре ключ-значение.

Parameters

string $key
mixed $values
bool $strict

Return Value

EnumeratesValues

EnumeratesValues whereInStrict(string $key, mixed $values)

Фильтровать элементы по заданной паре ключ-значение с использованием строгого сравнения.

Parameters

string $key
mixed $values

Return Value

EnumeratesValues

EnumeratesValues whereBetween(string $key, array $values)

Фильтровать элементы так, чтобы значение заданного ключа находилось между заданными значениями.

Parameters

string $key
array $values

Return Value

EnumeratesValues

EnumeratesValues whereNotBetween(string $key, array $values)

Фильтровать элементы так, чтобы значение заданного ключа не находилось между заданными значениями.

Parameters

string $key
array $values

Return Value

EnumeratesValues

EnumeratesValues whereNotIn(string $key, mixed $values, bool $strict = false)

Фильтровать элементы по заданной паре ключ-значение.

Parameters

string $key
mixed $values
bool $strict

Return Value

EnumeratesValues

EnumeratesValues whereNotInStrict(string $key, mixed $values)

Фильтровать элементы по заданной паре ключ-значение с использованием строгого сравнения.

Parameters

string $key
mixed $values

Return Value

EnumeratesValues

EnumeratesValues whereInstanceOf(string $type)

Фильтровать элементы, удаляя любые элементы, которые не соответствуют заданному типу.

Parameters

string $type

Return Value

EnumeratesValues

mixed pipe(callable $callback)

Передать коллекцию заданному обращению и вернуть результат.

Parameters

callable $callback

Return Value

mixed

$this tap(callable $callback)

Передать коллекцию заданному обращению, а затем вернуть её.

Parameters

callable $callback

Return Value

$this

EnumeratesValues reject(callable|mixed $callback = true)

Создать коллекцию всех элементов, которые не проходят заданный тест истинности.

Parameters

callable|mixed $callback

Return Value

EnumeratesValues

EnumeratesValues unique(string|callable|null $key = null, bool $strict = false)

Возвратить только уникальные элементы из массива коллекции.

Parameters

string|callable|null $key
bool $strict

Return Value

EnumeratesValues

EnumeratesValues uniqueStrict(string|callable|null $key = null)

Возвратить только уникальные элементы из массива коллекции с использованием строгого сравнения.

Parameters

string|callable|null $key

Return Value

EnumeratesValues

Collection collect()

Собрать значения в коллекцию.

Return Value

Collection

array toArray()

Получить коллекцию элементов как обычный массив.

Return Value

array

array jsonSerialize()

Преобразовать объект в что-то сериализуемое в JSON.

Return Value

array

string toJson(int $options = 0)

Получить коллекцию элементов как JSON.

Parameters

int $options

Return Value

string

CachingIterator getCachingIterator(int $flags = CachingIterator::CALL_TOSTRING)

Получить экземпляр CachingIterator.

Параметры

int $flags

Возвращаемое значение

CachingIterator

EnumeratesValues countBy(callable|null $callback = null)

Подсчитать количество элементов в коллекции с помощью заданного теста истинности.

Параметры

callable|null $callback

Возвращаемое значение

EnumeratesValues

string __toString()

Преобразовать коллекцию в её строковое представление.

Возвращаемое значение

string

static void proxy(string $method)

Добавить метод в список проксируемых методов.

Параметры

string $method

Возвращаемое значение

void

mixed __get(string $key)

Динамически получить доступ к проксированию коллекции.

Параметры

string $key

Возвращаемое значение

mixed

Исключения

Exception

protected array getArrayableItems(mixed $items)

Результат массива элементов из Collection или Arrayable.

Параметры

mixed $items

Возвращаемое значение

array

protected Closure operatorForWhere(string $key, string|null $operator = null, mixed $value = null)

Получить обратный вызов проверки оператора.

Параметры

string $key
string|null $operator
mixed $value

Возвращаемое значение

Closure

protected bool useAsCallable(mixed $value)

Определить, является ли данное значение вызываемым, но не строкой.

Параметры

mixed $value

Возвращаемое значение

bool

protected callable valueRetriever(callable|string|null $value)

Получить обратный вызов извлечения значения.

Параметры

callable|string|null $value

Возвращаемое значение

callable

static void macro(string $name, object|callable $macro)

Регистрация пользовательского макроса.

Параметры

string $name
object|callable $macro

Возвращаемое значение

void

static void mixin(object $mixin, bool $replace = true)

Смешивание другого объекта в класс.

Параметры

object $mixin
bool $replace

Возвращаемое значение

void

Исключения

ReflectionException

static bool hasMacro(string $name)

Проверка на наличие зарегистрированного макроса.

Параметры

string $name

Возвращаемое значение

bool

static mixed __callStatic(string $method, array $parameters)

Динамическая обработка вызовов к классу.

Параметры

string $method
array $parameters

Возвращаемое значение

mixed

Исключения

BadMethodCallException

mixed __call(string $method, array $parameters)

Динамическая обработка вызовов к классу.

Параметры

string $method
array $parameters

Возвращаемое значение

mixed

Исключения

BadMethodCallException

void __construct(mixed $items = [])

Создание новой коллекции.

Параметры

mixed $items

Возвращаемое значение

void

static Enumerable times(int $number, callable $callback = null)

Создание новой коллекции путём вызова обратного вызова заданное количество раз.

Параметры

int $number
callable $callback

Возвращаемое значение

Enumerable

array all()

Получить все элементы в коллекции.

Возвращаемое значение

array

LazyCollection lazy()

Получить ленивую коллекцию для элементов в этой коллекции.

Возвращаемое значение

LazyCollection

mixed avg(callable|string|null $callback = null)

Получить среднее значение заданного ключа.

Параметры

callable|string|null $callback

Возвращаемое значение

mixed

mixed median(string|array|null $key = null)

Получить медианное значение заданного ключа.

Параметры

string|array|null $key

Возвращаемое значение

mixed

array|null mode(string|array|null $key = null)

Получить моду (значение, встречающееся чаще всего) для заданного ключа.

Parameters

string|array|null $key

Return Value

array|null

Enumerable collapse()

Свести коллекцию элементов в один массив.

Return Value

Enumerable

bool contains(mixed $key, mixed $operator = null, mixed $value = null)

Определить, существует ли элемент в коллекции.

Parameters

mixed $key
mixed $operator
mixed $value

Return Value

bool

Collection crossJoin(mixed ...$lists)

Перекрестное соединение с заданными списками, возвращающее все возможные перестановки.

Parameters

mixed ...$lists

Return Value

Collection

Enumerable diff(mixed $items)

Получить элементы в коллекции, отсутствующие в заданных элементах.

Parameters

mixed $items

Return Value

Enumerable

Enumerable diffUsing(mixed $items, callable $callback)

Получить элементы в коллекции, отсутствующие в заданных элементах, используя обратный вызов.

Parameters

mixed $items
callable $callback

Return Value

Enumerable

Enumerable diffAssoc(mixed $items)

Получить элементы в коллекции, у которых ключи и значения отсутствуют в заданных элементах.

Parameters

mixed $items

Return Value

Enumerable

Enumerable diffAssocUsing(mixed $items, callable $callback)

Получить элементы в коллекции, у которых ключи и значения отсутствуют в заданных элементах, используя обратный вызов.

Parameters

mixed $items
callable $callback

Return Value

Enumerable

Enumerable diffKeys(mixed $items)

Получить элементы в коллекции, у которых ключи отсутствуют в заданных элементах.

Parameters

mixed $items

Return Value

Enumerable

Enumerable diffKeysUsing(mixed $items, callable $callback)

Получить элементы в коллекции, у которых ключи отсутствуют в заданных элементах, используя обратный вызов.

Parameters

mixed $items
callable $callback

Return Value

Enumerable

Enumerable duplicates(callable|null $callback = null, bool $strict = false)

Получить дубликаты элементов из коллекции.

Parameters

callable|null $callback
bool $strict

Return Value

Enumerable

Enumerable duplicatesStrict(callable|null $callback = null)

Получить дубликаты элементов из коллекции с использованием строгого сравнения.

Parameters

callable|null $callback

Return Value

Enumerable

protected Closure duplicateComparator(bool $strict)

Получить функцию сравнения для обнаружения дубликатов.

Parameters

bool $strict

Return Value

Closure

Enumerable except(mixed $keys)

Получить все элементы, кроме тех, у которых указаны ключи.

Parameters

mixed $keys

Return Value

Enumerable

Enumerable filter(callable $callback = null)

Применить фильтр к каждому из элементов.

Parameters

callable $callback

Return Value

Enumerable

mixed first(callable $callback = null, mixed $default = null)

Получить первый элемент из коллекции, удовлетворяющий заданному условию.

Parameters

callable $callback
mixed $default

Return Value

mixed

Collection flatten(int $depth = INF)

Получить сплющеный массив элементов из коллекции.

Parameters

int $depth

Return Value

Collection

Enumerable flip()

Перевернуть элементы в коллекции.

Return Value

Enumerable

$this forget(string|array $keys)

Удалить элемент из коллекции по ключу.

Параметры

string|array $keys

Значение результата

$this

mixed get(mixed $key, mixed $default = null)

Получить элемент из коллекции по ключу.

Параметры

mixed $key
mixed $default

Значение результата

mixed

Enumerable groupBy(array|callable|string $groupBy, bool $preserveKeys = false)

Сгруппировать ассоциативный массив по полю или с помощью обратного вызова.

Параметры

array|callable|string $groupBy
bool $preserveKeys

Значение результата

Enumerable

Enumerable keyBy(callable|string $keyBy)

Установить ключи ассоциативного массива по полю или с помощью обратного вызова.

Параметры

callable|string $keyBy

Значение результата

Enumerable

bool has(mixed $key)

Определить, существует ли элемент в коллекции по ключу.

Параметры

mixed $key

Значение результата

bool

string implode(string $value, string $glue = null)

Объединить значения заданного ключа в строку.

Параметры

string $value
string $glue

Значение результата

string

Enumerable intersect(mixed $items)

Пересечь коллекцию с заданными элементами.

Параметры

mixed $items

Значение результата

Enumerable

Enumerable intersectByKeys(mixed $items)

Пересечь коллекцию с заданными элементами по ключу.

Параметры

mixed $items

Значение результата

Enumerable

bool isEmpty()

Определить, пустая ли коллекция.

Значение результата

bool

string join(string $glue, string $finalGlue = '')

Объединить все элементы коллекции, используя строку. Для последних элементов можно использовать отдельную строку склейки.

Параметры

string $glue
string $finalGlue

Значение результата

string

Enumerable keys()

Получить ключи элементов коллекции.

Значение результата

Enumerable

mixed last(callable $callback = null, mixed $default = null)

Получить последний элемент из коллекции.

Параметры

callable $callback
mixed $default

Значение результата

mixed

Enumerable pluck(string|array $value, string|null $key = null)

Получить значения заданного ключа.

Параметры

string|array $value
string|null $key

Значение результата

Enumerable

Enumerable map(callable $callback)

Применить функцию к каждому элементу.

Параметры

callable $callback

Значение результата

Enumerable

Enumerable mapToDictionary(callable $callback)

Применить функцию к каждому элементу, возвращая словарь.

Функция обратного вызова должна возвращать ассоциативный массив с одной парой ключ/значение.

Параметры

callable $callback

Значение результата

Enumerable

Enumerable mapWithKeys(callable $callback)

Применить функцию к каждому элементу, возвращая ассоциативный массив.

Функция обратного вызова должна возвращать ассоциативный массив с одной парой ключ/значение.

Параметры

callable $callback

Значение результата

Enumerable

Enumerable merge(mixed $items)

Объединить коллекцию с заданными элементами.

Параметры

mixed $items

Значение результата

Enumerable

Enumerable mergeRecursive(mixed $items)

Рекурсивно объединить коллекцию с заданными элементами.

Параметры

mixed $items

Значение результата

Enumerable

Enumerable combine(mixed $values)

Создать коллекцию, используя текущую коллекцию для ключей и другую для значений.

Параметры

mixed $values

Значение результата

Enumerable

Enumerable union(mixed $items)

Объединить коллекцию с заданными элементами.

Parameters

mixed $items

Return Value

Enumerable

Enumerable nth(int $step, int $offset = 0)

Создать новую коллекцию, состоящую из каждого n-го элемента.

Parameters

int $step
int $offset

Return Value

Enumerable

Enumerable only(mixed $keys)

Получить элементы с указанными ключами.

Parameters

mixed $keys

Return Value

Enumerable

mixed pop()

Получить и удалить последний элемент из коллекции.

Return Value

mixed

$this prepend(mixed $value, mixed $key = null)

Добавить элемент в начало коллекции.

Parameters

mixed $value
mixed $key

Return Value

$this

$this push(mixed $value)

Добавить элемент в конец коллекции.

Parameters

mixed $value

Return Value

$this

Enumerable concat(iterable $source)

Добавить все заданные элементы в коллекцию.

Parameters

iterable $source

Return Value

Enumerable

mixed pull(mixed $key, mixed $default = null)

Получить и удалить элемент из коллекции.

Parameters

mixed $key
mixed $default

Return Value

mixed

$this put(mixed $key, mixed $value)

Поместить элемент в коллекцию по ключу.

Parameters

mixed $key
mixed $value

Return Value

$this

Enumerable|mixed random(int|null $number = null)

Получить один или заданное количество элементов случайным образом из коллекции.

Parameters

int|null $number

Return Value

Enumerable|mixed

Exceptions

InvalidArgumentException

mixed reduce(callable $callback, mixed $initial = null)

Свести коллекцию к одному значению.

Parameters

callable $callback
mixed $initial

Return Value

mixed

Enumerable replace(mixed $items)

Заменить элементы коллекции на заданные.

Parameters

mixed $items

Return Value

Enumerable

Enumerable replaceRecursive(mixed $items)

Рекурсивно заменить элементы коллекции на заданные.

Parameters

mixed $items

Return Value

Enumerable

Enumerable reverse()

Инвертировать порядок элементов.

Return Value

Enumerable

mixed search(mixed $value, bool $strict = false)

Поиск значения в коллекции и возвращение соответствующего ключа при успехе.

Parameters

mixed $value
bool $strict

Return Value

mixed

mixed shift()

Получить и удалить первый элемент из коллекции.

Return Value

mixed

Enumerable shuffle(int $seed = null)

Перемешать элементы в коллекции.

Parameters

int $seed

Return Value

Enumerable

Enumerable skip(int $count)

Пропустить первые {$count} элементов.

Parameters

int $count

Return Value

Enumerable

Enumerable slice(int $offset, int $length = null)

Выделить подмассив из базовой коллекции.

Parameters

int $offset
int $length

Return Value

Enumerable

Enumerable split(int $numberOfGroups)

Разделить коллекцию на определенное количество групп.

Parameters

int $numberOfGroups

Return Value

Enumerable

Enumerable chunk(int $size)

Разбить коллекцию на куски заданного размера.

Parameters

int $size

Return Value

Enumerable

Enumerable sort(callable $callback = null)

Сортировать каждый элемент с помощью обратного вызова.

Parameters

callable $callback

Return Value

Enumerable

Enumerable sortBy(callable|string $callback, int $options = SORT_REGULAR, bool $descending = false)

Сортировать коллекцию с помощью указанного обратного вызова.

Parameters

callable|string $callback
int $options
bool $descending

Return Value

Enumerable

Enumerable sortByDesc(callable|string $callback, int $options = SORT_REGULAR)

Сортировать коллекцию в порядке убывания с помощью указанного обратного вызова.

Parameters

callable|string $callback
int $options

Return Value

Enumerable

Enumerable sortKeys(int $options = SORT_REGULAR, bool $descending = false)

Сортировать ключи коллекции.

Parameters

int $options
bool $descending

Return Value

Enumerable

Enumerable sortKeysDesc(int $options = SORT_REGULAR)

Сортировать ключи коллекции в порядке убывания.

Parameters

int $options

Return Value

Enumerable

Collection splice(int $offset, int|null $length = null, mixed $replacement = [])

Вставить часть массива коллекции.

Parameters

int $offset
int|null $length
mixed $replacement

Return Value

Collection

Enumerable take(int $limit)

Взять первые или последние {$limit} элементы.

Parameters

int $limit

Return Value

Enumerable

$this transform(callable $callback)

Преобразовать каждый элемент коллекции с помощью обратного вызова.

Parameters

callable $callback

Return Value

$this

Enumerable values()

Сбросить ключи в базовом массиве.

Return Value

Enumerable

Collection zip(mixed $items)

Объединить коллекцию с одним или несколькими массивами.

Например: new Collection([1, 2, 3])->zip([4, 5, 6]); => [[1, 4], [2, 5], [3, 6]]

Parameters

mixed $items

Return Value

Collection

Enumerable pad(int $size, mixed $value)

Заполнить коллекцию до указанной длины значением.

Parameters

int $size
mixed $value

Return Value

Enumerable

ArrayIterator getIterator()

Получить итератор для элементов.

Return Value

ArrayIterator

int count()

Подсчитать количество элементов в коллекции.

Return Value

int

$this add(mixed $item)

Добавить элемент в коллекцию.

Parameters

mixed $item

Return Value

$this

Collection toBase()

Получить базовый экземпляр поддержки коллекции из этой коллекции.

Return Value

Collection

bool offsetExists(mixed $key)

Определить, существует ли элемент по смещению.

Parameters

mixed $key

Return Value

bool

mixed offsetGet(mixed $key)

Получить элемент по заданному смещению.

Parameters

mixed $key

Return Value

mixed

void offsetSet(mixed $key, mixed $value)

Установить элемент по заданному смещению.

Parameters

mixed $key
mixed $value

Return Value

void

void offsetUnset(string $key)

Удалить элемент по заданному смещению.

Parameters

string $key

Return Value

void

© Taylor Otwell
Licensed under the MIT License.
Laravel is a trademark of Taylor Otwell.
https://laravel.com/api/6.x/Illuminate/Support/Collection.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API