PHP - 對映函式

Map 是一個鍵值對的順序集合，與類似上下文中使用的陣列幾乎相同。鍵可以是任何型別，但必須是唯一的，如果使用相同的鍵新增到對映中，則會替換值。

優勢

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

劣勢

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

函式列表

以下是Map 類提供的函式列表：

序號	函式及描述
1	Ds\Map::allocate() 函式此函式可以為所需容量分配足夠的記憶體。
2	Ds\Map::apply() 函式此函式可以透過對每個值應用回撥函式來更新所有值。
3	Ds\Map::capacity() 函式此函式可以返回當前容量。
4	Ds\Map::clear() 函式此函式可以移除所有值。
5	Ds\Map::copy() 函式此函式可以返回對映的淺複製。
6	Ds\Map::count() 函式此函式可以返回對映中的值的數量。
7	Ds\Map::diff() 函式此函式可以透過使用不在另一個對映中的鍵來建立一個新對映。
8	Ds\Map::filter() 函式此函式可以透過使用可呼叫物件來確定要包含哪些鍵值對，從而建立一個新對映。
9	Ds\Map::first() 函式此函式可以返回對映中的第一對。
10	Ds\Map::get() 函式此函式可以返回給定鍵的值。
11	Ds\Map::hasKey() 函式此函式可以確定對映是否包含給定鍵。
12	Ds\Map::hasValue() 函式此函式可以確定對映是否包含給定值。
13	Ds\Map::intersect() 函式此函式可以透過與另一個對映的鍵相交來建立一個新對映。
14	Ds\Map::isEmpty() 函式此函式可以返回對映是否為空。
15	Ds\Map::jsonSerialize() 函式此函式可以返回可以轉換為 JSON 的表示形式。
16	Ds\Map::keys() 函式此函式可以返回對映鍵的集合。
17	Ds\Map::ksort() 函式此函式可以按鍵對對映進行就地排序。
18	Ds\Map::ksorted() 函式此函式可以返回按鍵排序的副本。
19	Ds\Map::last() 函式此函式可以返回對映的最後一對。
20	Ds\Map::map() 函式此函式可以返回將回調應用於每個值的結果。
21	Ds\Map::merge() 函式此函式可以返回新增所有給定關聯的結果。
22	Ds\Map::pairs() 函式此函式可以返回包含對映所有鍵值對的序列。
23	Ds\Map::put() 函式此函式可以將鍵與值關聯。
24	Ds\Map::putAll() 函式此函式可以關聯可遍歷物件或陣列的所有鍵值對。
25	Ds\Map::reduce() 函式此函式可以透過使用回撥函式將對映縮減為單個值。
26	Ds\Map::remove() 函式此函式可以按鍵移除並返回一個值。
27	Ds\Map::reverse() 函式此函式可以對對映進行就地反轉。
28	Ds\Map::reversed() 函式此函式可以返回反轉的副本。
29	Ds\Map::skip() 函式此函式可以返回給定位置索引處的鍵值對。
30	Ds\Map::slice() 函式此函式可以返回由起始索引和長度定義的對映的子集。
31	Ds\Map::sort() 函式此函式可以按值對對映進行就地排序。
32	Ds\Map::sorted() 函式此函式可以返回按值排序的副本。
33	Ds\Map::sum() 函式此函式可以返回對映中所有值的總和。
34	Ds\Map::toArray() 函式此函式可以將對映轉換為陣列。
35	Ds\Map::union() 函式此函式可以使用當前例項和另一個對映中的值建立一個新對映。
36	Ds\Map::values() 函式此函式可以返回對映值的序列。
37	Ds\Map::xor() 函式此函式可以使用當前例項或另一個對映的鍵建立一個新對映，但不能同時使用兩個對映的鍵。

php_function_reference.htm

列印頁面

序號	函式及描述
1	Ds\Map::allocate() 函式此函式可以為所需容量分配足夠的記憶體。
2	Ds\Map::apply() 函式此函式可以透過對每個值應用回撥函式來更新所有值。
3	Ds\Map::capacity() 函式此函式可以返回當前容量。
4	Ds\Map::clear() 函式此函式可以移除所有值。
5	Ds\Map::copy() 函式此函式可以返回對映的淺複製。
6	Ds\Map::count() 函式此函式可以返回對映中的值的數量。
7	Ds\Map::diff() 函式此函式可以透過使用不在另一個對映中的鍵來建立一個新對映。
8	Ds\Map::filter() 函式此函式可以透過使用可呼叫物件來確定要包含哪些鍵值對，從而建立一個新對映。
9	Ds\Map::first() 函式此函式可以返回對映中的第一對。
10	Ds\Map::get() 函式此函式可以返回給定鍵的值。
11	Ds\Map::hasKey() 函式此函式可以確定對映是否包含給定鍵。
12	Ds\Map::hasValue() 函式此函式可以確定對映是否包含給定值。
13	Ds\Map::intersect() 函式此函式可以透過與另一個對映的鍵相交來建立一個新對映。
14	Ds\Map::isEmpty() 函式此函式可以返回對映是否為空。
15	Ds\Map::jsonSerialize() 函式此函式可以返回可以轉換為 JSON 的表示形式。
16	Ds\Map::keys() 函式此函式可以返回對映鍵的集合。
17	Ds\Map::ksort() 函式此函式可以按鍵對對映進行就地排序。
18	Ds\Map::ksorted() 函式此函式可以返回按鍵排序的副本。
19	Ds\Map::last() 函式此函式可以返回對映的最後一對。
20	Ds\Map::map() 函式此函式可以返回將回調應用於每個值的結果。
21	Ds\Map::merge() 函式此函式可以返回新增所有給定關聯的結果。
22	Ds\Map::pairs() 函式此函式可以返回包含對映所有鍵值對的序列。
23	Ds\Map::put() 函式此函式可以將鍵與值關聯。
24	Ds\Map::putAll() 函式此函式可以關聯可遍歷物件或陣列的所有鍵值對。
25	Ds\Map::reduce() 函式此函式可以透過使用回撥函式將對映縮減為單個值。
26	Ds\Map::remove() 函式此函式可以按鍵移除並返回一個值。
27	Ds\Map::reverse() 函式此函式可以對對映進行就地反轉。
28	Ds\Map::reversed() 函式此函式可以返回反轉的副本。
29	Ds\Map::skip() 函式此函式可以返回給定位置索引處的鍵值對。
30	Ds\Map::slice() 函式此函式可以返回由起始索引和長度定義的對映的子集。
31	Ds\Map::sort() 函式此函式可以按值對對映進行就地排序。
32	Ds\Map::sorted() 函式此函式可以返回按值排序的副本。
33	Ds\Map::sum() 函式此函式可以返回對映中所有值的總和。
34	Ds\Map::toArray() 函式此函式可以將對映轉換為陣列。
35	Ds\Map::union() 函式此函式可以使用當前例項和另一個對映中的值建立一個新對映。
36	Ds\Map::values() 函式此函式可以返回對映值的序列。
37	Ds\Map::xor() 函式此函式可以使用當前例項或另一個對映的鍵建立一個新對映，但不能同時使用兩個對映的鍵。