Map 类

    (PECL ds >= 1.0.0)

    简介

    Map 是一个键值对的顺序集合，与类似上下文中使用的 数组 几乎完全相同。键可以是任何类型，但必须唯一。如果使用相同的键添加到 map 中，则值将被替换。

    优点

    • 键和值可以是任何类型，包括对象。
    • 支持数组语法（方括号）。
    • 保留插入顺序。
    • 性能和内存效率与 数组 非常相似。
    • 当其大小降至足够低时会自动释放分配的内存。

    缺点

    • 当对象用作键时，无法转换为数组。

    类概要

    class Ds\Map implements Ds\Collection, ArrayAccess {
    /* 常量 */
    const int MIN_CAPACITY = 16;
    /* 方法 */
    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
    }

    预定义常量

    Ds\Map::MIN_CAPACITY

    变更日志

    版本 描述
    PECL ds 1.3.0 该类现在实现了 ArrayAccess。

    目录

    改进此页面

    了解如何改进此页面 • 提交拉取请求 • 报告错误
    ＋添加说明

    用户贡献说明

    此页面没有用户贡献说明。
    To Top