Интерфейс Sequence

(Информация о версии неизвестна, возможно, только в SVN)

Введение

Последовательность описывает поведение, при котором значения распределены в одном, линейном порядке. В некоторых языках данное поведение описывается как "List". Это похоже на массив, в котором используются целочисленные ключи, за исключением нескольких моментов:

Значения всегда проиндексированы по порядку [0, 1, 2, …, size - 1].
Можно обращаться только к значениям индексированным в диапазоне [0, size - 1].

В каких случаях используется:

Если вы хотите использовать массив как список (не обращая внимания на ключи).
Более эффективная альтернатива для SplDoublyLinkedList и SplFixedArray.

Обзор интерфейсов

Ds\Sequence implements Ds\Collection {

/* Методы */

abstract public void allocate ( int $capacity )

abstract public void apply ( callable $callback )

abstract public int capacity ( void )

abstract public bool contains ([ mixed $...values ] )

abstract public Ds\Sequence filter ([ callable $callback ] )

abstract public mixed find ( mixed $value )

abstract public mixed first ( void )

abstract public mixed get ( int $index )

abstract public void insert ( int $index [, mixed $...values ] )

abstract public string join ([ string $glue ] )

abstract public mixed last ( void )

abstract public Ds\Sequence map ( callable $callback )

abstract public Ds\Sequence merge ( mixed $values )

abstract public mixed pop ( void )

abstract public void push ([ mixed $...values ] )

abstract public mixed reduce ( callable $callback [, mixed $initial ] )

abstract public mixed remove ( int $index )

abstract public void reverse ( void )

abstract public Ds\Sequence reversed ( void )

abstract public void rotate ( int $rotations )

abstract public void set ( int $index , mixed $value )

abstract public mixed shift ( void )

abstract public Ds\Sequence slice ( int $index [, int $length ] )

abstract public void sort ([ callable $comparator ] )

abstract public Ds\Sequence sorted ([ callable $comparator ] )

abstract public number sum ( void )

abstract public void unshift ([ mixed $values ] )

}

Содержание

Ds\Sequence::allocate — Выделение памяти под указанную вместимость
Ds\Sequence::apply — Обновление всех значений применением к ним переданной callback-функции
Ds\Sequence::capacity — Возвращает текущую вместимость
Ds\Sequence::contains — Проверяет, содержится ли в коллекции заданные значения
Ds\Sequence::filter — Создает новую последовательность из элементов, выбранных с помощью заданной callback-функции
Ds\Sequence::find — Поиск индекса по значению
Ds\Sequence::first — Возвращает первый элемент коллекции
Ds\Sequence::get — Возвращает значение по индексу
Ds\Sequence::insert — Вставляет значения по указанному индексу
Ds\Sequence::join — Склеивает все значения в строку
Ds\Sequence::last — Возвращает последнее значение коллекции
Ds\Sequence::map — Возвращает результат применения callback-функции ко всем значениям коллекции
Ds\Sequence::merge — Возвращает результат добавления всех заданных значений в коллекцию
Ds\Sequence::pop — Удаляет и возвращает последнее значение
Ds\Sequence::push — Добавляет значения в конец последовательности
Ds\Sequence::reduce — Схлопывает коллекцию до одного значения используя callback-функцию
Ds\Sequence::remove — Удаляет и возвращает значение по индексу
Ds\Sequence::reverse — Переворачивает текущую коллекцию
Ds\Sequence::reversed — Возвращает перевернутую копию коллекции
Ds\Sequence::rotate — Перематывает последовательность на заданное число значений
Ds\Sequence::set — Заменяет значение по указанному индексу
Ds\Sequence::shift — Удаляет и возвращает первое значение
Ds\Sequence::slice — Возвращает под-коллекцию из заданного диапазона
Ds\Sequence::sort — Сортирует коллекцию
Ds\Sequence::sorted — Возвращает отсортированную по значению копию коллекции
Ds\Sequence::sum — Возвращает сумму всех значений коллекции
Ds\Sequence::unshift — Добавляет значения в начало последовательности