PHP Ds\Map pair()函数介绍

在 PHP Ds\Map 类中，pair() 函数用于创建一个由两个成员组成的数组，其中第一个成员作为键(key)，第二个成员作为值(value)。常常用于在生成固定格式的数组时，快速设置键值对关系。

语法

public function pair(mixed $key, mixed $value): array

参数：

• $key: 键值对的键，可以是任何类型。
• $value: 键值对的值，可以是任何类型。

返回值：

• 返回一个包含两个成员的数组。

示例

在下面的示例中，我们创建了两个键值对，然后将它们添加到一个空的 Map 中。在这个过程中，使用了 pair() 函数快速创建了键值对数组。

<?php

$map = new \Ds\Map();
$map->put(...$map->pair('name', 'Lucas'))
    ->put(...$map->pair('age', 26));

print_r($map);

?>

输出结果：

Ds\Map Object
(
    [0] => Array
        (
            [0] => name
            [1] => Lucas
        )

    [1] => Array
        (
            [0] => age
            [1] => 26
        )

)

注意事项

• Ds\Map 类在 PHP 7.1 新增，如果你的 PHP 版本 < 7.1，需要先升级到 PHP 7.1 或以上版本才可以使用。
• pair() 函数只负责创建数组，如果需要将数组添加到 Map 中，需要使用 put() 方法。
• 当键值对中键重复时，后添加的值会覆盖先前的值。

参考资料

• PHP 官方文档：https://www.php.net/manual/zh/ds-map.pair.php