ArrayList是Bean数据扩展处理

加入 Bean数据

$userBean = UserBean::new(0, "testName");
arrayList($userBean);

//[["user_id"=>0,"user_name"=>"test"]]

all()

all 方法返回代表集合的底层数组：

arrayList([1,2,3])->all();

// [1,2,3]

avg()

average()

avg 方法的别名。

avg()

avg 方法返回指定键的平均值：

$average = arrayList([['foo' => 10], ['foo' => 10], ['foo' => 20], ['foo' => 40]])->avg('foo');
var_dump($average);
//int(20)
$average = arrayList([1, 1, 2, 4])->avg();
var_dump($average);
//int(2)

chunk()

chunk 方法将集合拆成多个指定大小的小集合：

$collection = collect([1, 2, 3, 4, 5, 6, 7]);
$chunks = $collection->chunk(4);
var_dump($chunks->all());

// [[1, 2, 3, 4], [5, 6, 7]]

collapse()

collapse 方法将多个数组的集合合并成一个数组的集合：

$list = arrayList([[1, 2, 3], [4, 5, 6], [7, 8, 9]]);
$list->collapse();
var_dump($list->toArr());

// [1, 2, 3, 4, 5, 6, 7, 8, 9]

contains()

contains 方法判断集合是否包含给定的项目：

$arrayList = arrayList(['name' => 'Desk', 'price' => 100]);
var_dump($arrayList->contains('Desk'));

// true

var_dump($arrayList->contains('New York'));

//false

你也可以用 contains 方法匹配一对键 / 值，即判断给定的配对是否存在于集合中：

$arrayList = arrayList([
    ['product' => 'Desk', 'price' => 200],
    ['product' => 'Chair', 'price' => 100],
]);
var_dump($arrayList->contains('product', 'Bookcase'));

//false

最后，你也可以传递一个回调到 contains 方法来执行自己的真实测试：

$res = ArrayList::new([ 1, 2, 3, 4, 5]);
var_dump($res->contains(function ($value, $key) {
    return $value > 5;
}));

//false

diff()

diff 方法将集合与其它集合或纯 PHP 数组进行值的比较，然后返回原集合中存在而给定集合中不存在的值：

$arrList = \arrayList([1, 2, 3, 4, 5]);
$arrList->diff([2, 4, 6, 8]);

$res = $arrList->all();
var_dump($res);

// [1, 3, 5]

diffAssoc()

diffAssoc 该方法与另外一个集合或基于它的键和值的 PHP 数组进行比较。这个方法会返回原集合不存在于给定集合中的键值对：

$collection = collect([
    'color' => 'orange',
    'type' => 'fruit',
    'remain' => 6
]);
$diff = $collection->diffAssoc([
    'color' => 'yellow',
    'type' => 'fruit',
    'remain' => 3,
    'used' => 6,
]);
$res = $diff->all();
var_dump($res);
// ['color' => 'orange', 'remain' => 6]

diffKeys()

diffKeys 方法与另外一个集合或 PHP 数组的「键」进行比较，然后返回原集合中存在而给定的集合中不存在「键」所对应的键值对：

$collection = arrayList([
    'one' => 10,
    'two' => 20,
    'three' => 30,
    'four' => 40,
    'five' => 50,
]);
$diff = $collection->diffKeys([
    'two' => 2,
    'four' => 4,
    'six' => 6,
    'eight' => 8,
]);
var_dump($diff->all());

// ['one' => 10, 'three' => 30, 'five' => 50]

column()

column 跟php array_column()一样功能；

$arrayList = arrayList([
    ['product_id' => 'prod-100', 'name' => 'Desk'],
    ['product_id' => 'prod-200', 'name' => 'Chair'],
]);
$res = $arrayList->column('name', 'product_id');
var_dump($res->toArr());

// [["prod-100"]=> "Desk", ["prod-200"]=> "Chair"]

keyBy()

keyBy 方法以给定的键作为集合的键。如果多个项目具有相同的键，则只有最后一个项目会显示在新集合中：

$arrayList = arrayList([
    ['product_id' => 'prod-100', 'name' => 'Desk'],
    ['product_id' => 'prod-200', 'name' => 'Chair'],
]);
$keyed = $collection->keyBy('product_id');
var_dump($res->all());
/*
    [
        'prod-100' => ['product_id' => 'prod-100', 'name' => 'Desk'],
        'prod-200' => ['product_id' => 'prod-200', 'name' => 'Chair'],
    ]
*/

你也可以传入一个回调方法，回调返回的值会作为该集合的键：

$arrayList = arrayList([
    ['product_id' => 'prod-100', 'name' => 'Desk'],
    ['product_id' => 'prod-200', 'name' => 'Chair'],
]);
$arr = $arrayList->keyBy(function ($item) {
    return strtoupper($item['product_id']);
});
var_dump($arr->all());

/*
    [
        'PROD-100' => ['product_id' => 'prod-100', 'name' => 'Desk'],
        'PROD-200' => ['product_id' => 'prod-200', 'name' => 'Chair'],
    ]
*/

groupBy()

groupBy 方法根据给定的键对集合内的项目进行分组：

$arrayList = arrayList([
    ['account_id' => 'account-x10', 'product' => 'Chair'],
    ['account_id' => 'account-x10', 'product' => 'Bookcase'],
    ['account_id' => 'account-x11', 'product' => 'Desk'],
]);

$grouped = $arrayList->groupBy('account_id');
var_dump($grouped->all());
/*
    [
        'account-x10' => [
            ['account_id' => 'account-x10', 'product' => 'Chair'],
            ['account_id' => 'account-x10', 'product' => 'Bookcase'],
        ],
        'account-x11' => [
            ['account_id' => 'account-x11', 'product' => 'Desk'],
        ],
    ]
*/

除了传入一个字符串的「键」，你还可以传入一个回调。该回调应该返回你希望用来分组的键的值。

$grouped = $arrayList->groupBy(function ($item) {
    return substr($item['account_id'], -3);
});
var_dump($grouped->all());
/*
    [
        'x10' => [
            ['account_id' => 'account-x10', 'product' => 'Chair'],
            ['account_id' => 'account-x10', 'product' => 'Bookcase'],
        ],
        'x11' => [
            ['account_id' => 'account-x11', 'product' => 'Desk'],
        ],
    ]
*/

可以传递一个数组用于多重分组标准。每一个数组元素将对应多维数组内的相应级别：

$list = arrayList([10 => ['user' => 1000, 'skill' => 100, 'roles' => ['Role_1', 'Role_3']],
    20 => ['user' => 2000, 'skill' => 100, 'roles' => ['Role_1', 'Role_2']],
    30 => ['user' => 3000, 'skill' => 200, 'roles' => ['Role_1']],
    40 => ['user' => 4000, 'skill' => 200, 'roles' => ['Role_2']],
    50 => ['user' => 4000, 'skill' => 200, 'roles' => ['Role_2']],
]);
$res = $list->groupBy(['skill',
    function ($item) {
        return $item['roles'];
    }
], true);
var_dump($res->toArr());
/*
[
    1 => [
        'Role_1' => [
            10 => ['user' => 1, 'skill' => 1, 'roles' => ['Role_1', 'Role_3']],
            20 => ['user' => 2, 'skill' => 1, 'roles' => ['Role_1', 'Role_2']],
        ],
        'Role_2' => [
            20 => ['user' => 2, 'skill' => 1, 'roles' => ['Role_1', 'Role_2']],
        ],
        'Role_3' => [
            10 => ['user' => 1, 'skill' => 1, 'roles' => ['Role_1', 'Role_3']],
        ],
    ],
    2 => [
        'Role_1' => [
            30 => ['user' => 3, 'skill' => 2, 'roles' => ['Role_1']],
        ],
        'Role_2' => [
            40 => ['user' => 4, 'skill' => 2, 'roles' => ['Role_2']],
        ],
    ],
];
*/

countBy()

countBy 方法计算集合中每个值的出现次数。默认情况下，该方法计算每个元素的出现次数：

$collection = collect([1, 2, 2, 2, 3]);
$counted = $collection->countBy();
var_dump($counted->all());

// [1 => 1, 2 => 3, 3 => 1]

但是，你也可以向 countBy 传递一个回调函数来计算自定义的值出现的次数:

$arrayList = arrayList(['alice@gmail.com', 'bob@yahoo.com', 'carlos@gmail.com']);
$arrayList = $arrayList->countBy(function ($email) {
    return substr(strrchr($email, "@"), 1);
});
var_dump($arrayList->all());

// ['gmail.com' => 2, 'yahoo.com' => 1]

crossJoin()

crossJoin 方法交叉连接指定数组或集合的值，返回所有可能排列的笛卡尔积:

$arrayList = arrayList([1, 2]);
$matrix = $arrayList->crossJoin(['a', 'b']);
$matrix->all();

/*
    [
        [1, 'a'],
        [1, 'b'],
        [2, 'a'],
        [2, 'b'],
    ]
*/

$arrayList = arrayList([1, 2]);
$matrix = $arrayList->crossJoin(['a', 'b'], ['I', 'II']);
var_dump($matrix->all());

/*
    [
        [1, 'a', 'I'],
        [1, 'a', 'II'],
        [1, 'b', 'I'],
        [1, 'b', 'II'],
        [2, 'a', 'I'],
        [2, 'a', 'II'],
        [2, 'b', 'I'],
        [2, 'b', 'II'],
    ]
*/

duplicates()

duplicates 方法从集合中检索并返回重复的值：

$arrayList = arrayList(['a', 'b', 'a', 'c', 'b']);
$res = $arrayList->duplicates();
var_dump($res->all());
// [2 => 'a', 4 => 'b']

$arrayList = arrayList([
    ['email' => 'abigail@example.com', 'position' => 'Developer'],
    ['email' => 'james@example.com', 'position' => 'Designer'],
    ['email' => 'victoria@example.com', 'position' => 'Developer'],
]);
$res = $arrayList->duplicates('position');
var_dump($res->all());

// [2 => 'Developer']

each()

each 方法用于循环集合项并将其传递到回调函数中：

$collection->each(function ($item, $key) {
    //
});

如果你想中断对集合项的循环，那么就在你的回调函数中返回 false ：

$collection->each(function ($item, $key) {
    if (/* some condition */) {
        return false;
    }
});

every()

every 方法可用于验证集合中的每一个元素是否通过指定的条件测试：

$res =arrayList([1, 2, 3, 4])->every(function ($value, $key) {
    return $value > 2;
});
var_dump($res);

// false

如果集合为空， every 将返回 true ：

$arrayList =ArrayList([]);
$arrayList->every(function ($value, $key) {
    return $value > 2;
});
//true

bean()

bean 操作列表中bean，bean是全新的：

$BStudent = BStudent::ArrayList();
$BStudent->bean()->setStudentNo(888);
$BStudent->push();

push()

push 将bean添加到列表中：

$BStudent = BStudent::ArrayList();
$BStudent->bean()->setStudentNo(888);
$BStudent->push();

update()

update 批量更新列表中数据：

$BStudent = BStudent::ArrayList();
$BStudent->bean()->setStudentNo(888);
$BStudent->update();

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

ArrayList.md

ArrayList.md

ArrayList是Bean数据扩展处理

加入 Bean数据

all()

avg()

chunk()

collapse()

contains()

diff()

diffAssoc()

diffKeys()

column()

keyBy()

groupBy()

countBy()

crossJoin()

duplicates()

each()

every()

bean()

push()

update()

Files

ArrayList.md

Latest commit

History

ArrayList.md

File metadata and controls

ArrayList是Bean数据扩展处理

加入 Bean数据

all()

avg()

chunk()

collapse()

contains()

diff()

diffAssoc()

diffKeys()

column()

keyBy()

groupBy()

countBy()

crossJoin()

duplicates()

each()

every()

bean()

push()

update()