Map 類別

(PECL ds >= 1.0.0)

簡介

Map 是一個鍵值對的序列集合，幾乎與在類似情況下使用的陣列相同。鍵可以是任何類型，但必須是唯一的。如果使用相同的鍵將值添加到 Map 中，則會替換值。

優點

鍵和值可以是任何類型，包括物件。
支援陣列語法（方括號）。
保留插入順序。
效能和記憶體效率與陣列非常相似。
當大小下降到足夠低時，會自動釋放已配置的記憶體。

缺點

當物件用作鍵時，無法轉換為陣列。

類別概要

class Ds\Map implements Ds\Collection, ArrayAccess {

/* 常數 */

const int MIN_CAPACITY = 16;

最小容量常數為 16。

/* 方法 */

public allocate(int $capacity): void

配置 Map 的容量。參數：`$capacity` (int) 容量。

public apply(callable $callback): void

將回呼函數應用於 Map 中的每個值。參數：`$callback` (callable) 要套用的回呼函數。

public capacity(): int

取得 Map 的容量。返回值：int 容量。

public clear(): void

清除 Map 中的所有元素。

public copy(): Ds\Map

複製 Map。返回值：Ds\Map Map 的副本。

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

計算當前 Map 與給定 Map 的差集。參數：`$map` (Ds\Map) 要比較的 Map。返回值：Ds\Map 包含存在於當前 Map 中但不存在於給定 Map 中的鍵值對的新 Map。

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

根據回呼函數過濾 Map 中的元素。參數：`$callback` (callable, 可選) 過濾回呼函數。返回值：Ds\Map 一個包含通過過濾器的新 Map。

public first(): Ds\Pair

取得 Map 中的第一個鍵值對。返回值：Ds\Pair 第一個鍵值對。

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

取得與給定鍵關聯的值。參數：`$key` (mixed) 鍵。 `$default` (mixed, 可選) 預設值，如果鍵不存在則返回。返回值：mixed 與鍵關聯的值。

public hasKey(mixed $key): bool

檢查 Map 是否包含給定的鍵。參數：`$key` (mixed) 鍵。返回值：bool 如果 Map 包含鍵，則返回 true，否則返回 false。

public hasValue(mixed $value): bool

檢查 Map 是否包含給定的值。參數：`$value` (mixed) 值。返回值：bool 如果 Map 包含值，則返回 true，否則返回 false。

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

計算當前 Map 與給定 Map 的交集。參數：`$map` (Ds\Map) 要比較的 Map。返回值：Ds\Map 一個包含兩個 Map 共有的鍵值對的新 Map。

public isEmpty(): bool

檢查 Map 是否為空。返回值：bool 如果 Map 為空，則返回 true，否則返回 false。

public keys(): Ds\Set

取得 Map 中所有鍵的集合。返回值：Ds\Set 包含所有鍵的集合。

public ksort(callable $comparator = ?): void

使用鍵排序 Map。參數：`$comparator` (callable, 可選) 比較函數。

公開 ksorted(可呼叫 $comparator = ?): Ds\Map

公開 last(): Ds\Pair

公開 map(可呼叫 $callback): Ds\Map

公開 merge(混合 $values): Ds\Map

公開 pairs(): Ds\Sequence

公開 put(混合 $key, 混合 $value): 無

公開 putAll(混合 $pairs): 無

公開 reduce(可呼叫 $callback, 混合 $initial = ?): 混合

公開 remove(混合 $key, 混合 $default = ?): 混合

公開 reverse(): 無

公開 reversed(): Ds\Map

公開 skip(整數 $position): Ds\Pair

公開 slice(整數 $index, 整數 $length = ?): Ds\Map

公開 sort(可呼叫 $comparator = ?): 無

公開 sorted(可呼叫 $comparator = ?): Ds\Map

公開 sum(): 整數|浮點數

公開 toArray(): 陣列

公開 union(Ds\Map $map): Ds\Map

公開 values(): Ds\Sequence

公開 xor(Ds\Map $map): Ds\Map

}

預定義常數

Ds\Map::MIN_CAPACITY

更新日誌

版本	說明
PECL ds 1.3.0	此類別現在實作 ArrayAccess。

Ds\Map::allocate — 配置足夠的記憶體以滿足所需的容量
Ds\Map::apply — 透過將回呼函式套用至每個值來更新所有值
Ds\Map::capacity — 傳回目前的容量
Ds\Map::clear — 移除所有值
Ds\Map::__construct — 建立新的實例
Ds\Map::copy — 傳回映射的淺層副本
Ds\Map::count — 傳回映射中的值數量
Ds\Map::diff — 使用另一個映射中不存在的鍵建立新的映射
Ds\Map::filter — 使用可呼叫物件來決定要包含哪些鍵值對，以建立新的映射
Ds\Map::first — 傳回映射中的第一個鍵值對
Ds\Map::get — 傳回指定鍵的值
Ds\Map::hasKey — 判斷映射是否包含指定的鍵
Ds\Map::hasValue — 判斷映射是否包含指定的值
Ds\Map::intersect — 透過與另一個映射交集鍵來建立新的映射
Ds\Map::isEmpty — 傳回映射是否為空
Ds\Map::jsonSerialize — 傳回可以轉換為 JSON 的表示法
Ds\Map::keys — 傳回映射鍵的集合
Ds\Map::ksort — 依鍵就地排序映射
Ds\Map::ksorted — 傳回依鍵排序的副本
Ds\Map::last — 傳回映射的最後一個鍵值對
Ds\Map::map — 將回呼函數應用於每個值，並返回結果
Ds\Map::merge — 返回添加所有給定關聯的結果
Ds\Map::pairs — 返回一個包含映射所有鍵值對的序列
Ds\Map::put — 將鍵與值關聯
Ds\Map::putAll — 關聯可遍歷對象或陣列的所有鍵值對
Ds\Map::reduce — 使用回呼函數將映射簡化為單個值
Ds\Map::remove — 移除並返回指定鍵的值
Ds\Map::reverse — 就地反轉映射
Ds\Map::reversed — 返回反轉後的副本
Ds\Map::skip — 返回指定位置索引處的鍵值對
Ds\Map::slice — 返回由起始索引和長度定義的映射子集
Ds\Map::sort — 按值就地排序映射
Ds\Map::sorted — 返回按值排序的副本
Ds\Map::sum — 返回映射中所有值的總和
Ds\Map::toArray — 將映射轉換為陣列
Ds\Map::union — 使用當前實例和另一個映射的值建立新的映射
Ds\Map::values — 返回映射值的序列
Ds\Map::xor — 建立一個新映射，使用當前實例或另一個映射的鍵，但不同時使用兩者的鍵

發現問題了嗎？

瞭解如何改進此頁面 • 提交拉取請求 • 回報錯誤

＋新增註釋

使用者提供的註釋

此頁面沒有使用者提供的註釋。