extended-array-object
PHP’s array functions brought into php objects., (*1)
The intention of this project is to extend the native ArrayObject with further array functions and
provide an easy way to apply subsequent array operations (like filter, map, diff, intersect) in a
concise way., (*2)
So far the spotlight is on working with single dimensional arrays. Recursive functions may be included
in another project., (*3)
Function Overview
the following functions are supported:, (*4)
Functions with identical behaviour and syntax
-
array_change_key_case() as changeKeyCase()
-
in_array() as contains()
-
array_count_values() as countValues()
-
array_filter() as filter()
-
array_flip() as flip()
-
implode() as join()
-
array_keys() as keys()
-
array_pop() as pop()
-
array_push() as push()
-
array_reverse() as reverse()
-
array_search() as search()
-
array_shift() as shift()
shuffle()-
array_slice() as slice()
-
array_splice() as splice()
-
array_unique() as unique()
-
array_unshift() as unshift()
-
array_values() as values()
Some methods have been renamed to better describe their functionality, (*5)
-
array_merge() as concat()
-
array_replace() as merge()
Functions with slightly modified behaviour or syntax
-
array_map() as map(), it does no accept multiple arrays. Instead it will always pass
the keys and values to the callback.
-
array_rand() as rand(), it returns the array elements instead of only the keys.
-
array_reduce() as reduce(), if no initial value is given, the first array element is used
as initial value.
-
*sort(), the native sort methods (ksort/asort) are extended to return the object instance.
-
array_walk() as walk(), if no userdata are given, the array itself is injected as userdata.
Functions with drastically changed behaviour or syntax
-
array_diff_*() as diff(), kdiff(), and adiff()
-
array_intersect_*() as intersect(), kintersect(), and aintersect()
-
replace() is a new function that works like array_replace() only without appending excess data.
Improved Error Handling
All methods throw exceptions when they encounter an error. This effectively allows to chain the methods together., (*6)
Examples
- Filtering for duplicate data in a POST variable
use Dormilich\Core\ArrayObject;
try {
$duplicates = ArrayObject::from($_POST['group'])
->map(function ($item) {
return $item['name'];
})
->countValues()
->filter(function ($count) {
return $count > 1;
})
->map(function ($count, $name) {
return sprintf('%d× %s', $count, $name);
})
;
if (count($duplicates)) {
$error_string = 'Duplicate names: ' . $duplicates->join(', ');
}
}
catch (Exception $exc) {
error_log($exc->getMessage());
}
Wallogit.com
