The Sequence interface

(PECL ds >= 1.0.0)

Introduction

A Sequence describes the behaviour of values arranged in a single, linear dimension. Some languages refer to this as a "List". It’s similar to an array that uses incremental integer keys, with the exception of a few characteristics:

Values will always be indexed as [0, 1, 2, …, size - 1].
Only allowed to access values by index in the range [0, size - 1].

Use cases:

Wherever you would use an array as a list (not concerned with keys).
A more efficient alternative to SplDoublyLinkedList and SplFixedArray.

Interface synopsis

interface Ds\Sequence extends Ds\Collection, ArrayAccess {

/* Methods */

abstract public function allocate(int $capacity): void

abstract public function apply(callable $callback): void

abstract public function capacity(): int

abstract public function contains(mixed ...$values): bool

abstract public function filter(callable $callback = ?): Ds\Sequence

abstract public function find(mixed $value): mixed

abstract public function first(): mixed

abstract public function get(int $index): mixed

abstract public function insert(int $index, mixed ...$values): void

abstract public function join(string $glue = ?): string

abstract public function last(): mixed

abstract public function map(callable $callback): Ds\Sequence

abstract public function merge(mixed $values): Ds\Sequence

abstract public function pop(): mixed

abstract public function push(mixed ...$values): void

abstract public function reduce(callable $callback, mixed $initial = ?): mixed

abstract public function remove(int $index): mixed

abstract public function reverse(): void

abstract public function reversed(): Ds\Sequence

abstract public function rotate(int $rotations): void

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

abstract public function shift(): mixed

abstract public function slice(int $index, int $length = ?): Ds\Sequence

abstract public function sort(callable $comparator = ?): void

abstract public function sorted(callable $comparator = ?): Ds\Sequence

abstract public function sum(): int|float

abstract public function unshift(mixed $values = ?): void

/* Inherited methods */

public function Ds\Collection::clear(): void

public function Ds\Collection::copy(): Ds\Collection

public function Ds\Collection::isEmpty(): bool

public function Ds\Collection::toArray(): array

public function Countable::count(): int

public function IteratorAggregate::getIterator(): Traversable

public function JsonSerializable::jsonSerialize(): mixed

public function ArrayAccess::offsetExists(mixed $offset): bool

public function ArrayAccess::offsetGet(mixed $offset): mixed

public function ArrayAccess::offsetSet(mixed $offset, mixed $value): void

public function ArrayAccess::offsetUnset(mixed $offset): void

}

Changelog

Version	Description
PECL ds 1.3.0	The interface now extends ArrayAccess.

Ds\Sequence::allocate — Allocates enough memory for a required capacity
Ds\Sequence::apply — Updates all values by applying a callback function to each value
Ds\Sequence::capacity — Returns the current capacity
Ds\Sequence::contains — Determines if the sequence contains given values
Ds\Sequence::filter — Creates a new sequence using a callable to determine which values to include
Ds\Sequence::find — Attempts to find a value's index
Ds\Sequence::first — Returns the first value in the sequence
Ds\Sequence::get — Returns the value at a given index
Ds\Sequence::insert — Inserts values at a given index
Ds\Sequence::join — Joins all values together as a string
Ds\Sequence::last — Returns the last value
Ds\Sequence::map — Returns the result of applying a callback to each value
Ds\Sequence::merge — Returns the result of adding all given values to the sequence
Ds\Sequence::pop — Removes and returns the last value
Ds\Sequence::push — Adds values to the end of the sequence
Ds\Sequence::reduce — Reduces the sequence to a single value using a callback function
Ds\Sequence::remove — Removes and returns a value by index
Ds\Sequence::reverse — Reverses the sequence in-place
Ds\Sequence::reversed — Returns a reversed copy
Ds\Sequence::rotate — Rotates the sequence by a given number of rotations
Ds\Sequence::set — Updates a value at a given index
Ds\Sequence::shift — Removes and returns the first value
Ds\Sequence::slice — Returns a sub-sequence of a given range
Ds\Sequence::sort — Sorts the sequence in-place
Ds\Sequence::sorted — Returns a sorted copy
Ds\Sequence::sum — Returns the sum of all values in the sequence
Ds\Sequence::unshift — Adds values to the front of the sequence

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes

There are no user contributed notes for this page.