La clase Set

(PECL ds >= 1.0.0)

Introducción

Un Set es una secuencia de valores únicos. Esta implementación utiliza la misma tabla de hash que Ds\Map, donde los valores se utilizan como claves y el valor mapeado se ignora.

Fortalezas

  • Los valores pueden ser de cualquier tipo, incluyendo objetos.
  • Soporte de la sintaxis de array (corchetes).
  • El orden de inserción se preserva.
  • Libera automáticamente la memoria asignada cuando su tamaño se vuelve suficientemente pequeño.
  • add(), remove() y contains() son todos de complejidad O(1).

Debilidades

  • No soporta: push(), pop(), insert(), shift(), o unshift().
  • get() es de complejidad O(n) si hay valores eliminados en el búfer antes del índice accedido, O(1) en caso contrario.

Sinopsis de la Clase

class Ds\Set implements Ds\Collection, ArrayAccess {
/* Constantes */
const int MIN_CAPACITY = 8;
/* Métodos */
public function add(mixed ...$values): void
public function allocate(int $capacity): void
public function capacity(): int
public function clear(): void
public function contains(mixed ...$values): bool
public function copy(): Ds\Set
public function diff(Ds\Set $set): Ds\Set
public function filter(callable $callback = ?): Ds\Set
public function first(): mixed
public function get(int $index): mixed
public function intersect(Ds\Set $set): Ds\Set
public function isEmpty(): bool
public function join(string $glue = ?): string
public function last(): mixed
public function map(callable $callback): Ds\Set
public function merge(mixed $values): Ds\Set
public function reduce(callable $callback, mixed $initial = ?): mixed
public function remove(mixed ...$values): void
public function reverse(): void
public function reversed(): Ds\Set
public function slice(int $index, int $length = ?): Ds\Set
public function sort(callable $comparator = ?): void
public function sorted(callable $comparator = ?): Ds\Set
public function sum(): int|float
public function toArray(): array
public function union(Ds\Set $set): Ds\Set
public function xor(Ds\Set $set): Ds\Set
}

Constantes predefinidas

Ds\Set::MIN_CAPACITY

Historial de cambios

Versión Descripción
PECL ds 1.3.0 Esta clase implementa ahora ArrayAccess.
PECL ds 1.2.7 Se añadió el método Ds\Set::map().
PECL ds 1.2.0 Ds\Set::MIN_CAPACITY cambió de 16 a 8.

Tabla de contenidos