//> 判断 $value 是否是 数组 或 ArrayAccess 的实例对象
/**
* Determine whether the given value is array accessible.
*
* @param mixed $value
* @return bool
*/
public static function accessible($value)
{
return is_array($value) || $value instanceof ArrayAccess;
}
//> is_array() 和 instanceof 返回 bool(true | false)
# ArrayAccess 接口类
//> 向指定数组中添加key-value一对键值
/**
* Add an element to an array using "dot" notation if it doesn't exist.
*
* @param array $array
* @param string $key
* @param mixed $value
* @return array
*/
public static function add($array, $key, $value)
{
if (is_null(static::get($array, $key))) {
static::set($array, $key, $value);
}
return $array;
}
//> 使用举例 ---- 如果key值,在array中存在,返回array;如果不存在,添加key-value键值对
$arr = [
'name' => [
'one' => 'One',
'tow' => 'Tow'
],
'sex' => 'man',
'age' => 12,
];
dump(Arr::add($arr,'name.three','bms'));
# 打印数据后的数据
$arr = [
'name' => [
'one' => 'One',
'tow' => 'Tow',
'three' => 'bms'
],
'sex' => 'man',
'age' => 12,
];
//> 获取给定key在给定array中的值,如果不存在，默认返回null
/**
* Get an item from an array using "dot" notation.
*
* @param \ArrayAccess|array $array
* @param string $key
* @param mixed $default
* @return mixed
*/
public static function get($array, $key, $default = null)
{
if (! static::accessible($array)) {
return value($default);
}
if (is_null($key)) {
return $array;
}
if (static::exists($array, $key)) {
return $array[$key];
}
foreach (explode('.', $key) as $segment) {
if (static::accessible($array) && static::exists($array, $segment)) {
$array = $array[$segment];
} else {
return value($default);
}
}
return $array;
}
//> 这里采用 . 代替 [] (数组的标识符)
//> 设置key-value一对键值对,添加入array数组中;如果存在key时，改为更新
/**
* Set an array item to a given value using "dot" notation.
*
* If no key is given to the method, the entire array will be replaced.
*
* @param array $array
* @param string $key
* @param mixed $value
* @return array
*/
public static function set(&$array, $key, $value)
{
if (is_null($key)) {
return $array = $value;
}
$keys = explode('.', $key);
while (count($keys) > 1) {
$key = array_shift($keys);
// If the key doesn't exist at this depth, we will just create an empty array
// to hold the next value, allowing us to create the arrays to hold final
// values at the correct depth. Then we'll keep digging into the array.
if (! isset($array[$key]) || ! is_array($array[$key])) {
$array[$key] = [];
}
$array = &$array[$key];
}
$array[array_shift($keys)] = $value;
return $array;
}
//> 举例 ----
$arr = [
'name' => [
'one' => 'One',
'tow' => 'Tow'
],
'sex' => 'man',
'age' => 12,
];
dump(Arr::set($arr,'name.one','t'));
# set 返回的是最后一个数组的值；我们可以看出set方法，采用的是&引用赋值,直接打印$arr就可以得到全部的改变的数据
# [
"one" => "t"
"tow" => "Tow"
]
dump(Arr::set($arr,'name.three','bms'));
# [
"one" => "t"
"tow" => "Tow"
"three" => "bms"
]
//> 随机打乱一个数组
/**
* Shuffle the given array and return the result.
*
* @param array $array
* @return array
*/
public static function shuffle($array)
{
shuffle($array);
return $array;
}
//> 使用回调函数过滤数组
/**
* Filter the array using the given callback.
*
* @param array $array
* @param callable $callback
* @return array
*/
public static function where($array, callable $callback)
{
return array_filter($array, $callback, ARRAY_FILTER_USE_BOTH);
}
//> 使用举例 ----
$arr = [
'name' => [
'one' => 'One',
'tow' => 'Tow'
],
'sex' => 'man',
'age' => 12,
];
dump(Arr::where($arr,function ($value,$key){
if( $key == 'sex' ){
return false;
}
if( $value % 2 == 0 ){
return true;
}
return true;
}));
# 打印结果 ----
"name" => array:2 [
"one" => "One"
"tow" => "Tow"
] "age" => 12
//> 数组排序,支持回调函数(排序规则：根据数组的值，进行排序)
/**
* Sort the array using the given callback or "dot" notation.
*
* @param array $array
* @param callable|string $callback
* @return array
*/
public static function sort($array, $callback)
{
return Collection::make($array)->sortBy($callback)->all();
}
//> 使用举例 ----
$arr = [
'name' => [
'one' => 'One',
'tow' => 'Tow'
],
'sex' => 'man',
'age' => 12,
];
$sortArr = Arr::sort($arr,function ($value,$key){
if( $key == 'name' ){
return 'a';
}
if( $key == 'age' ){
return 'z';
}
return 'g';
});
dump($sortArr);
# 打印数据
[
"name" => array:2 [
"one" => "One"
"tow" => "Tow"
]
"sex" => "man" "age" => 12
]
# 根据sortBy()方法，貌似回调函数返回的是排序字符串
//> 数组排序函数：根据 Key 值进行排序
/**
* Recursively sort an array by keys and values.
*
* @param array $array
* @return array
*/
public static function sortRecursive($array)
{
foreach ($array as &$value) {
if (is_array($value)) {
$value = static::sortRecursive($value);
}
}
if (static::isAssoc($array)) {
ksort($array);
} else {
sort($array);
}
return $array;
}
# 使用举例 -----
$arr = [
'name' => [
'one' => 'One',
'tow' => 'Tow'
],
'sex' => 'man',
'age' => 12,
];
dump(Arr::sortRecursive($arr));
# 打印结果
[
"age" => 12
"name" => array:2 [
"one" => "One"
"tow" => "Tow"
]
"sex" => "man"
]
//> 从 指定数组中 获取指定的值,并从该数组中移除该key
/**
* Get a value from the array, and remove it.
*
* @param array $array
* @param string $key
* @param mixed $default
* @return mixed
*/
public static function pull(&$array, $key, $default = null)
{
$value = static::get($array, $key, $default);
static::forget($array, $key);
return $value;
}
//> 举例 ----
$arr = [
'name' => [
'one' => 'One',
'tow' => 'Tow'
],
'sex' => 'man',
'age' => 12,
];
dump(Arr::pull($arr,'name.tow',null));
dump($arr);
# 打印数据 ----
"Tow"
array:3 [
"name" => array:1 [
"one" => "One"
]
"sex" => "man"
"age" => 12
]
网友评论