La interfaz Sequence

(PECL ds >= 1.0.0)

Introducción

Una Sequence describe el comportamiento de los valores dispuestos en una sola dimensión lineal. Algunos lenguajes se refieren a esto como una "Lista". Es similar a un array que utiliza claves enteras incrementales, con la excepción de algunas características:

Los valores siempre serán indexados como [0, 1, 2, …, size - 1].
Solo los valores por índice en el rango [0, size - 1] están permitidos.

Casos de uso:

En cualquier lugar donde se utilizaría un array como lista (sin preocuparse por las claves).
Una alternativa más eficiente a SplDoublyLinkedList y SplFixedArray.

Sinopsis de la Interfaz

interface Ds\Sequence extends Ds\Collection, ArrayAccess {

/* Métodos */

abstract public allocate(int $capacity): void

abstract public apply(callable $callback): void

abstract public capacity(): int

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

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

abstract public find(mixed $value): mixed

abstract public first(): mixed

abstract public get(int $index): mixed

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

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

abstract public last(): mixed

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

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

abstract public pop(): mixed

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

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

abstract public remove(int $index): mixed

abstract public reverse(): void

abstract public reversed(): Ds\Sequence

abstract public rotate(int $rotations): void

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

abstract public shift(): mixed

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

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

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

abstract public sum(): int|float

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

/* Métodos heredados */

public Ds\Collection::clear(): void

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

public Ds\Collection::isEmpty(): bool

public Ds\Collection::toArray(): array

public Countable::count(): int

public IteratorAggregate::getIterator(): Traversable

abstract public JsonSerializable::jsonSerialize(): mixed

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

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

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

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

}

Historial de cambios

Versión	Descripción
PECL ds 1.3.0	Esta interfaz ahora extiende ArrayAccess.

Tabla de contenidos

Ds\Sequence::allocate — Asigna suficiente memoria para una capacidad requerida
Ds\Sequence::apply — Actualiza todos los valores aplicando una retrollamada a cada valor
Ds\Sequence::capacity — Devuelve la capacidad actual
Ds\Sequence::contains — Determina si la secuencia contiene valores dados
Ds\Sequence::filter — Crear una nueva secuencia utilizando un callable para determinar qué valores incluir
Ds\Sequence::find — Intenta encontrar el índice de un valor.
Ds\Sequence::first — Devuelve el primer valor de la secuencia
Ds\Sequence::get — Devuelve el valor en un índice dado
Ds\Sequence::insert — Inserta valores en un índice dado
Ds\Sequence::join — Reúne todos los valores en un string
Ds\Sequence::last — Devuelve el último valor
Ds\Sequence::map — Devuelve el resultado de la aplicación de una retrollamada a cada valor
Ds\Sequence::merge — Devuelve el resultado de la adición de todos los valores de la secuencia
Ds\Sequence::pop — Elimina y devuelve el último valor
Ds\Sequence::push — Añade valores al final de la secuencia
Ds\Sequence::reduce — Reduce la secuencia a un solo valor utilizando una función de retrollamada
Ds\Sequence::remove — Elimina y devuelve un valor por índice
Ds\Sequence::reverse — Invierte la secuencia en el lugar
Ds\Sequence::reversed — Devuelve una copia invertida
Ds\Sequence::rotate — Rota la secuencia un número dado de rotaciones
Ds\Sequence::set — Actualiza un valor en un índice dado
Ds\Sequence::shift — Elimina y devuelve el primer valor
Ds\Sequence::slice — Devuelve una subsecuencia de un rango dado
Ds\Sequence::sort — Ordena la secuencia en su lugar
Ds\Sequence::sorted — Devuelve una copia ordenada
Ds\Sequence::sum — Devuelve la suma de todos los valores de la secuencia
Ds\Sequence::unshift — Añade valores al inicio de la secuencia

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.