lamansky/map

一个可迭代的键值集合类。

维护者

详细信息

github.com/lamansky/map

主页

源代码

问题

安装: 8

依赖: 0

建议者: 0

安全: 0

星星: 0

关注者: 3

分支: 0

开放问题: 0

1.0.0 2020-08-18 21:39 UTC

Requires

  • php: >=7.1.0

Requires (Dev)

MIT e6235acf3c4efe3fd432feeb660149b58fc7a78d

mapcollectionkey-value

This package is not auto-updated.

Last update: 2024-09-26 12:28:45 UTC

README

PHP 的可迭代键值集合类。

安装

在您的计算机上已安装并初始化了 Composer 的情况下，请在项目根目录中运行此命令

composer require lamansky/map

需要 PHP 7.1 或更高版本。

库由一个类组成：Lamansky\Map\Map。

基本用法

<?php
use Lamansky\Map\Map;

$map = new Map();

// Set
$map->set('key', 'value');

// Has
var_dump($map->has('key')); // bool(true)

// Get
echo $map->get('key'); // 'value'

// Keys & Values
print_r($map->keys()); // Array ( [0] => key )
print_r($map->values()); // Array ( [0] => value )

// Iteration
foreach ($map as $key => $value) {
}

// Count
var_dump($map->count()); // int(1)

// Delete
var_dump($map->delete('key')); // bool(true) // found
var_dump($map->delete('key')); // bool(false) // not found

方法

要了解这些方法各自的作用，请参考 tests/MapTest.php 中的单元测试。

  • get ($key)
  • has ($key)
  • set ($key, $value)
  • mergeSet ($key, $value, callable $merge)
  • edit ($key, callable $edit)
  • increment ($key, $value)
  • decrement ($key, $value)
  • delete ($key)
  • count ()
  • entries ()
  • keys ()
  • values ()
  • map (callable $callback)
  • walk (callable $callback)
  • sort (callable $sort)
  • sortValuesAsc ()
  • sortValuesDesc ()
  • sortKeysAsc ()
  • sortKeysDesc ()
  • keepOnlyTheFirst (int $number)
  • keepOnlyTheLast (int $number)

静态方法

  • fromList (iterable $items, callable $get_key)
  • merge (self ...$maps)
  • deepMerge (callable $merge, self ...$maps)

单元测试

要运行开发测试套件，请执行此命令

./vendor/phpunit/phpunit/phpunit tests