La clase Map

(PECL ds >= 1.0.0)

Introducción

Un Map es una colección secuencial de pares clave-valor, casi identico a un array usado en un contexto similar. Las claves pueden ser de cualquier tipo, pero deben ser únicos. Los valores se reemplazan si se agregan al mapa usando la misma clave.

Fortalezas

Las claves y valores pueden ser de cualquer tipo, incluyendo objetos.
Soporta la sintaxis array (corchetes).
Se mantiene el orden de inserción.
El rendimiento y la eficiencia de memoria son muy similares al de un array.
Automáticamente libera la memoria asignada cuando su tamaño cae lo suficientemente bajo.

Debilidades

No puede ser convertido a un array cuando los objetos son usados como claves.

Sinopsis de la Clase

class Ds\Map implements Ds\Collection, ArrayAccess {

/* Constantes */

const int MIN_CAPACITY = 8;

/* Métodos */

public allocate(int $capacity): void

public apply(callable $callback): void

public capacity(): int

public clear(): void

public copy(): Ds\Map

public diff(Ds\Map $map): Ds\Map

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

public first(): Ds\Pair

public get(mixed $key, mixed $default = ?): mixed

public hasKey(mixed $key): bool

public hasValue(mixed $value): bool

public intersect(Ds\Map $map): Ds\Map

public isEmpty(): bool

public keys(): Ds\Set

public ksort(callable $comparator = ?): void

public ksorted(callable $comparator = ?): Ds\Map

public last(): Ds\Pair

public map(callable $callback): Ds\Map

public merge(mixed $values): Ds\Map

public pairs(): Ds\Sequence

public put(mixed $key, mixed $value): void

public putAll(mixed $pairs): void

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

public remove(mixed $key, mixed $default = ?): mixed

public reverse(): void

public reversed(): Ds\Map

public skip(int $position): Ds\Pair

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

public sort(callable $comparator = ?): void

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

public sum(): int|float

public toArray(): array

public union(Ds\Map $map): Ds\Map

public values(): Ds\Sequence

public xor(Ds\Map $map): Ds\Map

}

Constantes predefinidas

Ds\Map::MIN_CAPACITY

Historial de cambios

Versión Descripción

PECL ds 1.3.0 La clase ahora implementa ArrayAccess.

PECL ds 1.2.0 Ds\Map::MIN_CAPACITY cambió de 16 a 8.

Versión	Descripción
PECL ds 1.3.0	La clase ahora implementa ArrayAccess.
PECL ds 1.2.0	`Ds\Map::MIN_CAPACITY` cambió de 16 a 8.

Tabla de contenidos

Ds\Map::allocate — Asigna suficiente memoria para una capacidad requerida
Ds\Map::apply — Actualiza todos los valores aplicando una retrollamada a cada valor
Ds\Map::capacity — Devuelve la capacidad actual
Ds\Map::clear — Elimina todos los valores
Ds\Map::__construct — Crear una nueva instancia
Ds\Map::copy — Devuelve una copia superficial del mapa
Ds\Map::count — Devuelve el número de valores en el mapa
Ds\Map::diff — Crear un nuevo map utilizando claves que no están en otro map
Ds\Map::filter — Crear un nuevo mapa utilizando un callable para determinar qué pares incluir
Ds\Map::first — Devuelve la primera pareja del mapa
Ds\Map::get — Devuelve el valor para una clave dada
Ds\Map::hasKey — Determina si el mapa contiene una clave dada
Ds\Map::hasValue — Determina si el mapa contiene un valor dado
Ds\Map::intersect — Crear un nuevo mapa intersectando las claves con otro mapa
Ds\Map::isEmpty — Indica si el mapa está vacío
Ds\Map::jsonSerialize — Devuelve una representación que puede ser convertida en JSON
Ds\Map::keys — Devuelve un conjunto de las claves del mapa
Ds\Map::ksort — Ordena el mapa en el lugar por clave
Ds\Map::ksorted — Devuelve una copia, ordenada por clave
Ds\Map::last — Devuelve el último par del mapa
Ds\Map::map — Devuelve el resultado de la aplicación de una retrollamada a cada valor
Ds\Map::merge — Devuelve el resultado de la adición de todas las asociaciones dadas
Ds\Map::pairs — Devuelve una secuencia que contiene todas las parejas del mapa
Ds\Map::put — Asocia una clave a un valor
Ds\Map::putAll — Asocia todas las parejas clave-valor de un objeto traversable o de un array
Ds\Map::reduce — Reduce el mapa a un solo valor utilizando una retrollamada
Ds\Map::remove — Elimina y devuelve un valor por clave
Ds\Map::reverse — Invierte el mapa en su lugar
Ds\Map::reversed — Devuelve una copia invertida
Ds\Map::skip — Devuelve el par a un índice de posición dado
Ds\Map::slice — Devuelve un subconjunto del mapa definido por un índice de inicio y una longitud
Ds\Map::sort — Ordena el mapa en el lugar por valor
Ds\Map::sorted — Devuelve una copia, ordenada por valor
Ds\Map::sum — Devuelve la suma de todos los valores del mapa
Ds\Map::toArray — Convierte el mapa en un array
Ds\Map::union — Crear un nuevo mapa utilizando los valores de la instancia actual y de otro mapa
Ds\Map::values — Devuelve una secuencia de los valores del mapa
Ds\Map::xor — Crear un nuevo mapa utilizando las claves de la instancia actual o de otro mapa, pero no de ambos