# 结构数据工具
# \drunk\Structure
数据结构工具，加工处理复合结构型数据
# ::arrayMerge()
递归合并数组
参数
array $array合并目标数组array ... $arrays待合数组
元素类型 处理方式 与目标数组皆为列表型数组 追加到目标数组尾部 与目标数组有对应的数组型元素 递归合并 非上述情况 将待合数组元素追加或覆盖到目标数组或元素 返回
array示例
\drunk\Structure::arrayMerge(
[1, 'a'=>[2]],
[2],
['a'=>[2]],
['b'=>[3]],
['b'=>4]
);
// [0=>1, 'a'=>[2, 2], 1=>2, 'b'=>4]
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
# ::arraySearch()
用回调函数在数组中查找匹配值的下标集
参数
callable $needle比对方法，返回真即命中array $haystack查找源bool $lazyMode = true是否惰性查找true若找到，则直接返回其下标false遍历完后返回匹配元素的下标集
返回
array|string|int|false
# ::arraySearchItem()
用回调函数在数组中查找匹配值集
参数
callable $needle比对方法，返回真即命中array $haystack查找源bool $lazyMode = true是否惰性查找true若找到，则直接返回其下标false遍历完后返回匹配元素的下标集
返回
mixed
# ::arraySearchMatrix()
查询 参1 在 参2 数组元素中是否有相同值, 返回其在参2中的索引值集
参数
array $needle待查找值array $haystack查找源bool $lazyMode = true是否惰性查找true若找到，则直接返回其下标false遍历完后返回匹配元素的下标集
返回
array|string|int|false示例
\drunk\Structure::arrayInArray([1, 'a'=>2], []);
// false
\drunk\Structure::arrayInArray([1, 'a'=>2], [[0=>1, 2, 'a'=>3], [1, 'a'=>2]]);
// 0
\drunk\Structure::arrayInArray([1, 'a'=>2], [[0=>1, 2, 'a'=>3], [1, 'a'=>2]], false);
// [0, 1]
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
# ::arraySplitKey()
拆分解析字符串为根键与数组下标集
参数
string $keystring & $rootKey? array & $keyArray
返回
void示例
\drunk\Structure::arrayAssignKey('cache.redis.host', $rootKey, $keyArray);
// $rootKey: cache
// $keyArray: ['redis', 'host']
1
2
3
2
3
# ::arrayAssign()
按结构数组下标对数组元素赋值
参数
array $array目标数组array $keyArray下标树集mixed $value待赋值值
返回
array|false示例
\drunk\Structure::arrayAssign([], ['a', 'b'], 1);
// ['a'=>['b'=>1]]
\drunk\Structure::arrayAssign(['a'=>1], ['a', 'b'], 1);
// false
1
2
3
4
5
2
3
4
5
# ::arrayIndexGet()
按结构数组下标取数组元素
参数
array $array目标数组array $$keyArray下标集
返回
array|null示例
\drunk\Structure::arrayIndexGet(['a'=>['b'=>1]], ['a', 'b']);
// 1
\drunk\Structure::arrayIndexGet(['a'=>['b'=>1]], ['a', 'c']);
// null
1
2
3
4
5
2
3
4
5
# ::arrayIndexDelete()
按结构数组下标集删除数组元素
参数
array & $array目标数组array $keyArray下标集
返回
null|bool示例
$target = ['a'=>['b'=>1]];
\drunk\Structure::arrayIndexDelete($target, ['a', 'b']);
// true
// $target: ['a'=>[]]
\drunk\Structure::arrayIndexDelete(['a'=>['b'=>1]], ['a', 'c']);
// false
// $target: ['a'=>['b'=>1]]
1
2
3
4
5
6
7
8
9
2
3
4
5
6
7
8
9
# ::arrayIsList()
是否列表式数组
参数
? array $array
返回
bool示例
\drunk\Structure::arrayIndexGet([0=>1, 1=>1]);
// true
\drunk\Structure::arrayIndexGet([2=>1, 3=>1]);
// false
1
2
3
4
5
2
3
4
5
# ::arrayEntries()
取键值元组集
参数
array|ArrayAccess|Iterator $iterator可遍历对象
返回
array
# ::forEach()
遍历对象并执行回调
参数
array|ArrayAccess|Iterator $iterator待遍历对象callable $callback回调方法
返回
void
# ::sortByColumnRef()
按照矩阵列值集为参考，将矩阵按该参考值列表排序（常用语in查询时，查询结果与in元素顺序不一致，此时可以用此方法方便的排序）
参数
array[]|ArrayAccess[] $matrix待排序的矩阵string $column排序参考列array $refValues排序参考值集
返回
array
# ::arrayChangeKeyCase()
将数组键格式化为驼峰或蛇底形式
参数
array $array待处理数组bool|null $bigCamel = false是否大驼峰true大驼峰false小驼峰null蛇底
返回
array