Arrays
\nn\t3::Arrays()
Various methods for working with arrays such as merging, cleaning or removing empty values. Methods to use a value of an associative array as a key.
Overview of Methods
\nn\t3::Arrays()->first();
Returns the first element of the array, without array_shift()
\nn\t3::Arrays( $objArr )->first();| @return array
\nn\t3::Arrays()->intExplode($delimiter = ',');
Split a string â or array â at the separator, remove non-numeric and remove empty elements
\nn\t3::Arrays('1,a,b,2,3')->intExplode(); // [1,2,3]
\nn\t3::Arrays(['1','a','2','3'])->intExplode(); // [1,2,3]| @return array
\nn\t3::Arrays()->key($key = 'uid', $value = false);
Use a field in the array as the key of the array, e.g. to get a list, whose key is always the UID of the associative array:
Example:
$arr = [['uid'=>'1', 'title'=>'Title A'], ['uid'=>'2', 'title'=>'Title B']];
\nn\t3::Arrays($arr)->key('uid'); // ['1'=>['uid'=>'1', 'title'=>'Title A'], '2'=>['uid'=>'2', 'title'=>'Title B']]
\nn\t3::Arrays($arr)->key('uid', 'title'); // ['1'=>'Title A', '2'=>'Title B']| @return array
\nn\t3::Arrays()->merge();
Merge an associative array recursively with another array.
$addKeys => if false, only keys that also exist in $arr1 are overwritten
$includeEmptyValues => if true, empty values are also included in $arr1
$enableUnsetFeature => if true, __UNSET can be used as a value in $arr2 to delete a value in $arr1
$mergedArray = \nn\t3::Arrays( $arr1 )->merge( $arr2, $addKeys, $includeEmptyValues, $enableUnsetFeature );
$mergedArray = \nn\t3::Arrays( $arr1 )->merge( $arr2 );
$mergedArray = \nn\t3::Arrays()->merge( $arr1, $arr2 );| @return array
\nn\t3::Arrays()->pluck($keys = NULL, $isSingleObject = false);
Reduce / distill associative array to specific elements:
\nn\t3::Arrays( $objArr )->key('uid')->pluck('title'); // ['1'=>'title A', '2'=>'title B']
\nn\t3::Arrays( $objArr )->key('uid')->pluck(['title', 'bodytext']); // ['1'=>['title'=>'Title A', 'bodytext'=>'Content'], '2'=>...]
\nn\t3::Arrays( ['uid'=>1, 'pid'=>2] )->pluck(['uid'], true); // ['uid'=>1]| @return array
\nn\t3::Arrays()->removeEmpty();
Remove empty values from an array.
$clean = \nn\t3::Arrays( $arr1 )->removeEmpty();| @return array
\nn\t3::Arrays()->toArray();
Returns this array object as a "normal" array.
\nn\t3::Arrays( $objArr )->key('uid')->toArray();| @return array
\nn\t3::Arrays()->trimExplode($delimiter = ',', $removeEmpty = true);
Split a string â or array â at the separator, remove empty elements Works with strings and arrays.
\nn\t3::Arrays('1,,2,3')->trimExplode(); // [1,2,3]
\nn\t3::Arrays('1,,2,3')->trimExplode( false ); // [1,'',2,3]
\nn\t3::Arrays('1|2|3')->trimExplode('|'); // [1,2,3]
\nn\t3::Arrays('1|2||3')->trimExplode('|', false); // [1,2,'',3]
\nn\t3::Arrays('1|2,3')->trimExplode(['|', ',']); // [1,2,3]
\nn\t3::Arrays(['1','','2','3'])->trimExplode(); // [1,2,3]| @return array