Array

Extended version of Laravel's Arr component.

• randomElement()
  • Seeding
• differenceAssoc()
• tree()

randomElement()

Returns a single random element from a given list.

use Aedart\Utils\Arr;

$element = Arr::randomElement(['Jim', 'Sine', 'Ally', 'Gordon']);

See also Laravel's Arr::random.

Seeding

You can also provide a seed for the random number generator.

use Aedart\Utils\Arr;
use Aedart\Utils\Math;

$element = Arr::randomElement(
    ['Jim', 'Sine', 'Ally', 'Gordon'],
    Math::seed(),
    MT_RAND_PHP
);

See Math::seed() and Math::applySeed() methods for additional information about seeding.

differenceAssoc()

Method computes the difference of two or more multidimensional arrays.

use Aedart\Utils\Arr;

$original = [
    'key' => 'person',
    'value' => 'John Snow',
    'settings' => [
        'validation' => [
            'required' => true,
            'nullable' => true,
            'min' => 2,
            'max' => 50,
        ]
    ]
];

$changed = [
    'key' => 'person',
    'value' => 'Smith Snow', // Changed
    'settings' => [
        'validation' => [
            'required' => false, // Changed
            'nullable' => true,
            'min' => 2,
            'max' => 100, // Changed
        ]
    ]
];

$result = Arr::differenceAssoc($original, $changed);
print_r($result);

The output of the above shown example will be the following:

Array
(
  ['value'] => 'John Snow'
  ['settings'] => Array
      (
          ['validation'] => Array
              (
                  ['required'] => 1
                  ['max'] => 50
              )
      )
)

tree()

Returns an array that represents a "tree" structure for given path.

use Aedart\Utils\Arr;

$result = Arr::tree('/home/user/projects');

print_r($result);

Array
(
    [0] => /home
    [1] => /home/user
    [2] => /home/user/projects
)