Arrayy\Arrayy

Complexity

Total Complexity

116

Size/Duplication

Total Lines	1104
Duplicated Lines	4.35 %

Coupling/Cohesion

Components	1
Dependencies	3

Test Coverage

Coverage

92.99%

Importance

Changes	20
Bugs	4	Features	14

68 Methods

Rating	Name	Duplication	Size	Complexity
B	__construct()	0	22	6
A	__toString()	0	4	1
A	__get()	0	4	1
A	__set()	0	4	1
A	__isset()	0	4	1
A	__unset()	0	4	1
A	offsetExists()	0	4	1
A	offsetGet()	0	4	2
A	getIterator()	0	4	1
A	__invoke()	0	12	3
A	getArray()	0	4	1
A	create()	0	4	1
A	offsetSet()	0	8	2
A	offsetUnset()	0	6	2
B	createFromString()	0	25	4
A	createFromJson()	0	6	1
A	searchValue()	0	15	3
A	searchIndex()	0	12	2
A	matches()	13	13	2
A	matchesAny()	13	13	2
A	isAssoc()	0	8	2
A	isMultiArray()	0	4	1
A	contains()	0	4	1
A	average()	0	14	3
A	length()	0	4	1
A	count()	0	4	1
A	size()	0	4	1
A	max()	0	8	2
A	min()	0	8	2
A	find()	0	10	3
A	clean()	0	8	1
A	random()	0	14	3
A	randomWeighted()	0	13	4
A	intersection()	0	4	1
A	intersects()	0	4	1
A	first()	0	10	2
A	last()	0	10	2
A	initial()	0	6	1
A	rest()	0	4	1
A	at()	10	10	2
A	mergeAppendNewIndex()	0	4	1
A	mergePrependNewIndex()	0	4	1
A	mergeAppendKeepIndex()	0	4	1
A	mergePrependKeepIndex()	0	4	1
A	diff()	0	4	1
A	diffReverse()	0	4	1
A	replaceOneValue()	0	11	2
A	replaceValues()	0	10	1
A	replaceKeys()	0	6	1
A	each()	0	10	2
A	shuffle()	0	8	1
A	split()	0	10	2
A	sortKeys()	0	19	3
A	implode()	0	4	1
A	getColumn()	0	4	1
A	filter()	0	10	2
A	invoke()	0	16	3
A	reject()	12	12	3
A	removeFirst()	0	6	1
A	removeLast()	0	6	1
B	removeValue()	0	18	5
A	prepend()	0	6	1
A	append()	0	6	1
A	reverse()	0	6	1
A	flip()	0	6	1
A	reduce()	0	6	1
A	unique()	0	16	2
A	toJson()	0	4	1

<?php

namespace Arrayy;

use ArrayAccess;
use voku\helper\UTF8;

/**
 * Methods to manage arrays.
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */
class Arrayy extends ArrayyAbstract implements \Countable, \IteratorAggregate, \ArrayAccess
{
  /**
   * Initializes
   *
   * @param array $array
   */
  public function __construct($array = array())
  {
    if (!$array) {

The expression $array of type array is implicitly converted to a boolean; are you sure this is intended? If so, consider using empty($expr) instead to make it clear that you intend to check for an array without elements.

      $array = array();
    }

    if (
        is_string($array)
        ||
        (is_object($array) && method_exists($array, '__toString'))
    ) {
      $array = (array)$array;
    }

    if (!is_array($array)) {
      throw new \InvalidArgumentException(
          'Passed value must be a array'
      );
    }

    $this->array = $array;
  }

  /**
   * magic to string
   *
   * @return string
   */
  public function __toString()
  {
    return $this->implode(',');
  }

  /**
   * Get a data by key
   *
   * @param $key
   *
   * @return mixed
   */
  public function &__get($key)
  {
    return $this->array[$key];
  }

  /**
   * Assigns a value to the specified data
   *
   * @param $key
   * @param $value
   */
  public function __set($key, $value)
  {
    $this->array[$key] = $value;
  }

  /**
   * Whether or not an data exists by key
   *
   * @param $key
   *
   * @return bool
   */
  public function __isset($key)
  {
    return isset($this->array[$key]);
  }

  /**
   * Unsets an data by key
   *
   * @param mixed $key
   */
  public function __unset($key)
  {
    unset($this->array[$key]);
  }

  /**
   * Assigns a value to the specified offset
   *
   *
   * @param mixed $offset
   * @param mixed $value
   */
  public function offsetSet($offset, $value)
  {
    if (null === $offset) {
      $this->array[] = $value;
    } else {
      $this->array[$offset] = $value;
    }
  }

  /**
   * Whether or not an offset exists
   *
   * @param mixed $offset
   *
   * @return bool
   */
  public function offsetExists($offset)
  {
    return isset($this->array[$offset]);
  }

  /**
   * Unsets an offset
   *
   * @param mixed $offset
   */
  public function offsetUnset($offset)
  {
    if ($this->offsetExists($offset)) {
      unset($this->array[$offset]);
    }
  }

  /**
   * Returns the value at specified offset
   *
   * @param mixed $offset
   *
   * @return null
   */
  public function offsetGet($offset)
  {
    return $this->offsetExists($offset) ? $this->array[$offset] : null;
  }

  /**
   * Returns a new ArrayIterator, thus implementing the IteratorAggregate
   * interface.
   *
   * @return \ArrayIterator An iterator for the values in the array
   */
  public function getIterator()
  {
    return new \ArrayIterator($this->array);
  }

  /**
   * call object as function
   *
   * @param mixed $key
   *
   * @return mixed
   */
  public function __invoke($key = null)
  {
    if ($key !== null) {
      if (isset($this->array[$key])) {
        return $this->array[$key];
      } else {
        return false;
      }
    }

    return (array)$this->array;
  }

  /**
   * get the current array from the "Arrayy"-object
   *
   * @return array
   */
  public function getArray()
  {
    return $this->array;
  }

  /**
   * Creates a Arrayy object
   *
   * @param array $array
   *
   * @return Arrayy
   */
  public static function create($array = array())
  {
    return new static($array);
  }

  /**
   * Create a new Arrayy object via string.
   *
   * @param string      $str       The input string.
   * @param string|null $delimiter The boundary string.
   * @param string|null $regEx     Use the $delimiter or the $regEx, so if $pattern is null, $delimiter will be used.
   *
   * @return Arrayy
   */
  public static function createFromString($str, $delimiter, $regEx = null)
  {
    if ($regEx) {

The expression $regEx of type string|null is loosely compared to true; this is ambiguous if the string can be empty. You might want to explicitly use !== null instead.

      preg_match_all($regEx, $str, $array);

      if (count($array) > 0) {
        $array = $array[0];
      }

    } else {
      $array = explode($delimiter, $str);
    }

    // trim all string in the array
    array_walk(
        $array,
        function (&$val) {
          if (is_string($val)) {
            $val = trim($val);
          }
        }
    );

    return self::create($array);
  }

  /**
   * create a new Arrayy object via JSON,
   *
   * @param string $json
   *
   * @return Arrayy
   */
  public static function createFromJson($json)
  {
    $array = UTF8::json_decode($json, true);

    return self::create($array);
  }

  ////////////////////////////////////////////////////////////////////
  ///////////////////////////// ANALYZE //////////////////////////////
  ////////////////////////////////////////////////////////////////////

  /**
   * Search for the value of the current array via $index.
   *
   * @param mixed $index
   *
   * @return Arrayy will return a empty Arrayy if the value wasn't found
   */
  public function searchValue($index)
  {
    // init
    $return = array();

    if (null !== $index) {
      $keyExists = isset($this->array[$index]);

      if ($keyExists !== false) {
        $return = array($this->array[$index]);
      }
    }

    return static::create((array)$return);
  }

  /**
   * Search for the first index of the current array via $value.
   *
   * @param mixed $value
   *
   * @return Arrayy will return a empty Arrayy if the index wasn't found
   */
  public function searchIndex($value)
  {
    $key = array_search($value, $this->array, true);

    if ($key === false) {
      $return = array();
    } else {
      $return = array($key);
    }

    return static::create((array)$return);
  }

  /**
   * Check if all items in current array match a truth test.
   *
   * @param \Closure $closure
   *
   * @return bool
   */
  public function matches(\Closure $closure)

This method seems to be duplicated in your project.

  {
    // Reduce the array to only booleans
    $array = $this->each($closure);

    // Check the results
    if (count($array) === 0) {
      return true;
    }
    $array = array_search(false, $array, false);

    return is_bool($array);
  }

  /**
   * Check if any item in the current array matches a truth test.
   *
   * @param \Closure $closure
   *
   * @return bool
   */
  public function matchesAny(\Closure $closure)

This method seems to be duplicated in your project.

  {
    // Reduce the array to only booleans
    $array = $this->each($closure);

    // Check the results
    if (count($array) === 0) {
      return true;
    }
    $array = array_search(true, $array, false);

    return is_int($array);
  }

  /**
   * Check if we have named keys in the current array.
   *
   * @return bool
   */
  public function isAssoc()
  {
    if (count($this->array) === 0) {
      return false;
    }

    return (bool)count(array_filter(array_keys($this->array), 'is_string'));
  }

  /**
   * Check if the current array is a multi-array.
   *
   * @return bool
   */
  public function isMultiArray()
  {
    return !(count($this->array) === count($this->array, COUNT_RECURSIVE));
  }

  /**
   * Check if an item is in the current array.
   *
   * @param mixed $value
   *
   * @return bool
   */
  public function contains($value)
  {
    return in_array($value, $this->array, true);
  }

  /**
   * Returns the average value of the current array.
   *
   * @param int $decimals The number of decimals to return
   *
   * @return int|double The average value
   */
  public function average($decimals = null)
  {
    $count = $this->count();

    if (!$count) {
      return 0;
    }

    if (!is_int($decimals)) {
      $decimals = null;
    }

    return round(array_sum($this->array) / $count, $decimals);
  }

  /**
   * Count the values from the current array.
   *
   * INFO: only a alias for "$arrayy->size()"
   *
   * @return int
   */
  public function length()
  {
    return $this->size();
  }

  /**
   * Count the values from the current array.
   *
   * INFO: only a alias for "$arrayy->size()"
   *
   * @return int
   */
  public function count()
  {
    return $this->size();
  }

  /**
   * Get the size of an array.
   *
   * @return int
   */
  public function size()
  {
    return count($this->array);
  }

  /**
   * Get the max value from an array.
   *
   * @return mixed
   */
  public function max()
  {
    if ($this->count() === 0) {
      return false;
    }

    return max($this->array);
  }

  /**
   * Get the min value from an array.
   *
   * @return mixed
   */
  public function min()
  {
    if ($this->count() === 0) {
      return false;
    }

    return min($this->array);
  }

  ////////////////////////////////////////////////////////////////////
  //////////////////////////// FETCH FROM ////////////////////////////
  ////////////////////////////////////////////////////////////////////

  /**
   * Find the first item in an array that passes the truth test,
   *  otherwise return false
   *
   * @param \Closure $closure
   *
   * @return mixed|false false if we couldn't find the value
   */
  public function find(\Closure $closure)
  {
    foreach ($this->array as $key => $value) {
      if ($closure($value, $key)) {
        return $value;
      }
    }

    return false;
  }

  /**
   * Clean all falsy values from an array.
   *
   * @return Arrayy
   */
  public function clean()
  {
    return $this->filter(
        function ($value) {
          return (bool)$value;
        }
    );
  }

  /**
   * Get a random string from an array.
   *
   * @param null|int $take how many values you will take?
   *
   * @return Arrayy
   */
  public function random($take = null)
  {
    if ($this->count() === 0) {
      return self::create(array());
    }

    if ($take === null) {
      return static::create((array)$this->array[array_rand($this->array)]);
    }

    shuffle($this->array);

    return $this->first($take);
  }

  /**
   * Get a random value from an array, with the ability to skew the results.
   *
   * Example: randomWeighted(['foo' => 1, 'bar' => 2]) has a 66% chance of returning bar.
   *
   * @param array    $array
   * @param null|int $take how many values you will take?
   *
   * @return Arrayy
   */
  public function randomWeighted(array $array, $take = null)
  {
    $options = array();
    foreach ($array as $option => $weight) {
      if ($this->searchIndex($option)->count() > 0) {
        for ($i = 0; $i < $weight; ++$i) {
          $options[] = $option;
        }
      }
    }

    return $this->mergeAppendKeepIndex($options)->random($take);
  }

  /**
   * Return an array with all elements found in input array.
   *
   * @param array $search
   *
   * @return Arrayy
   */
  public function intersection(array $search)
  {
    return static::create(array_values(array_intersect($this->array, $search)));
  }

  /**
   * Return a boolean flag which indicates whether the two input arrays have any common elements.
   *
   * @param array $search
   *
   * @return bool
   */
  public function intersects(array $search)
  {
    return count($this->intersection($search)->array) > 0;
  }

  ////////////////////////////////////////////////////////////////////
  ///////////////////////////// SLICERS //////////////////////////////
  ////////////////////////////////////////////////////////////////////

  /**
   * Get the first value(s) from the current array.
   *
   * @param int|null $take how many values you will take?
   *
   * @return Arrayy
   */
  public function first($take = null)
  {
    if ($take === null) {
      $array = array_shift($this->array);
    } else {
      $array = array_splice($this->array, 0, $take, true);
    }

    return static::create((array)$array);
  }

  /**
   * Get the last value(s) from the current array.
   *
   * @param int|null $take
   *
   * @return Arrayy
   */
  public function last($take = null)
  {
    if ($take === null) {
      $array = static::create((array)array_pop($this->array));
    } else {
      $array = $this->rest(-$take);
    }

    return $array;
  }

  /**
   * Get everything but the last..$to items.
   *
   * @param int $to
   *
   * @return Arrayy
   */
  public function initial($to = 1)
  {
    $slice = count($this->array) - $to;

    return $this->first($slice);
  }

  /**
   * Get the last elements from index $from until the end of this array.
   *
   * @param int $from
   *
   * @return Arrayy
   */
  public function rest($from = 1)
  {
    return static::create(array_splice($this->array, $from));
  }

  ////////////////////////////////////////////////////////////////////
  ///////////////////////////// ACT UPON /////////////////////////////
  ////////////////////////////////////////////////////////////////////

  /**
   * Iterate over an array and execute a callback for each loop.
   *
   * @param \Closure $closure
   *
   * @return Arrayy
   */
  public function at(\Closure $closure)

This method seems to be duplicated in your project.

  {
    $array = $this->array;

    foreach ($array as $key => $value) {
      $closure($value, $key);
    }

    return static::create($array);
  }

  ////////////////////////////////////////////////////////////////////
  ////////////////////////////// ALTER ///////////////////////////////
  ////////////////////////////////////////////////////////////////////

  /**
   * Merge the new $array into the current array.
   *
   * - replace duplicate assoc-keys from the current array with the key,values from the new $array
   * - create new indexes
   *
   * @param array $array
   *
   * @return Arrayy
   */
  public function mergeAppendNewIndex(array $array = array())
  {
    return static::create(array_merge($this->array, $array));
  }

  /**
   * Merge the current array into the new $array.
   *
   * - replace duplicate assoc-keys from new $array with the key,values from the current array
   * - create new indexes
   *
   * @param array $array
   *
   * @return Arrayy
   */
  public function mergePrependNewIndex(array $array = array())
  {
    return static::create(array_merge($array, $this->array));
  }

  /**
   * Merge the new $array into the current array.
   *
   * - keep key,value from the current array, also if the index is in the new $array
   *
   * @param array $array
   *
   * @return Arrayy
   */
  public function mergeAppendKeepIndex(array $array = array())
  {
    return static::create(array_replace($this->array, $array));
  }

  /**
   * Merge the the current array into the $array.
   *
   * - use key,value from the new $array, also if the index is in the current array
   *
   * @param array $array
   *
   * @return Arrayy
   */
  public function mergePrependKeepIndex(array $array = array())
  {
    return static::create(array_replace($array, $this->array));
  }

  /**
   * Return values that are only in the current array.
   *
   * @param array $array
   *
   * @return Arrayy
   */
  public function diff(array $array = array())
  {
    return static::create(array_diff($this->array, $array));
  }

  /**
   * Return values that are only in the new $array.
   *
   * @param array $array
   *
   * @return Arrayy
   */
  public function diffReverse(array $array = array())
  {
    return static::create(array_diff($array, $this->array));
  }

  /**
   * Replace the first matched value in an array.
   *
   * @param mixed $search
   * @param mixed $replacement
   *
   * @return Arrayy
   */
  public function replaceOneValue($search, $replacement = '')
  {
    $array = $this->array;
    $key = array_search($search, $array, true);

    if ($key !== false) {
      $array[$key] = $replacement;
    }

    return static::create($array);
  }

  /**
   * Replace values in the current array.
   *
   * @param string $search      The string to replace.
   * @param string $replacement What to replace it with.
   *
   * @return Arrayy
   */
  public function replaceValues($search, $replacement = '')
  {
    $array = $this->each(
        function ($value) use ($search, $replacement) {
          return UTF8::str_replace($search, $replacement, $value);
        }
    );

    return static::create((array)$array);
  }

  /**
   * Replace the keys in an array with another set.
   *
   * @param array $keys An array of keys matching the array's size
   *
   * @return Arrayy
   */
  public function replaceKeys(array $keys)
  {
    $values = array_values($this->array);

    return static::create(array_combine($keys, $values));
  }

  /**
   * Iterate over the current array and modify the array's value.
   *
   * @param \Closure $closure
   *
   * @return array
   */
  public function each(\Closure $closure)
  {
    $array = $this->array;

    foreach ($array as $key => &$value) {
      $value = $closure($value, $key);
    }

    return $array;
  }

  /**
   * Shuffle the current array.
   *
   * @return Arrayy
   */
  public function shuffle()
  {
    $array = $this->array;

    shuffle($array);

    return static::create($array);
  }


  /**
   * Split an array in the given amount of pieces.
   *
   * @param int  $numberOfPieces
   * @param bool $preserveKeys
   *
   * @return array
   */
  public function split($numberOfPieces = 2, $preserveKeys = false)
  {
    if (count($this->array) === 0) {
      return self::create(array());
    }

    $splitSize = ceil(count($this->array) / $numberOfPieces);

    return self::create(array_chunk($this->array, $splitSize, $preserveKeys));
  }

  /**
   * Sort the current array by key.
   *
   * @param string $direction
   *
   * @return Arrayy
   */
  public function sortKeys($direction = 'ASC')
  {
    $array = $this->array;
    $direction = strtolower($direction);

    if ($direction === 'desc') {
      $directionType = SORT_DESC;
    } else {
      $directionType = SORT_ASC;
    }

    if ($directionType === SORT_ASC) {
      ksort($array);
    } else {
      krsort($array);
    }

    return static::create($array);
  }

  /**
   * Implodes an array.
   *
   * @param string $with What to implode it with
   *
   * @return string
   */
  public function implode($with = '')
  {
    return implode($with, $this->array);
  }

  /**
   * Returns the values from a single column of the input array, identified by
   * the $columnKey, can be used to extract data-columns from multi-arrays.
   *
   * Info: Optionally, you may provide an $indexKey to index the values in the returned
   * array by the values from the $indexKey column in the input array.
   *
   * @param mixed $columnKey
   * @param mixed $indexKey
   *
   * @return Arrayy
   */
  public function getColumn($columnKey = null, $indexKey = null)
  {
    return self::create(array_column($this->array, $columnKey, $indexKey));

It seems like array_column($this->array, $columnKey, $indexKey) targeting array_column() can also be of type false or null; however, Arrayy\Arrayy::create() does only seem to accept array, maybe add an additional type check?

  }

  /**
   * Find all items in an array that pass the truth test.
   *
   * @param \Closure|null $closure
   *
   * @return Arrayy
   */
  public function filter($closure = null)
  {
    if (!$closure) {
      return $this->clean();
    }

    $array = array_filter($this->array, $closure);

    return static::create($array);
  }

  /**
   * Invoke a function on all of an array's values.
   *
   * @param mixed $callable
   * @param array $arguments
   *
   * @return Arrayy
   */
  public function invoke($callable, $arguments = array())
  {
    // If one argument given for each iteration, create an array for it.
    if (!is_array($arguments)) {
      $arguments = StaticArrayy::repeat($arguments, count($this->array))->getArray();
    }

    // If the callable has arguments, pass them.
    if ($arguments) {

The expression $arguments of type array is implicitly converted to a boolean; are you sure this is intended? If so, consider using ! empty($expr) instead to make it clear that you intend to check for an array without elements.

      $array = array_map($callable, $this->array, $arguments);
    } else {
      $array = array_map($callable, $this->array);
    }

    return static::create($array);
  }

  /**
   * Return all items that fail the truth test.
   *
   * @param \Closure $closure
   *
   * @return Arrayy
   */
  public function reject(\Closure $closure)

This method seems to be duplicated in your project.

  {
    $filtered = array();

    foreach ($this->array as $key => $value) {
      if (!$closure($value, $key)) {
        $filtered[$key] = $value;
      }
    }

    return static::create($filtered);
  }

  /**
   * Remove the first value from the current array.
   *
   * @return Arrayy
   */
  public function removeFirst()
  {
    array_shift($this->array);

    return static::create($this->array);
  }

  /**
   * Remove the last value from the current array.
   *
   * @return Arrayy
   */
  public function removeLast()
  {
    array_pop($this->array);

    return static::create($this->array);
  }

  /**
   * Removes a particular value from an array (numeric or associative).
   *
   * @param mixed $value
   *
   * @return Arrayy
   */
  public function removeValue($value)
  {
    $isNumericArray = true;
    foreach ($this->array as $key => $item) {
      if ($item === $value) {
        if (!is_int($key)) {
          $isNumericArray = false;
        }
        unset($this->array[$key]);
      }
    }

    if ($isNumericArray) {
      $this->array = array_values($this->array);
    }

    return static::create($this->array);
  }

  /**
   * Prepend a value to an array.
   *
   * @param mixed $value
   *
   * @return Arrayy
   */
  public function prepend($value)
  {
    array_unshift($this->array, $value);

    return static::create($this->array);
  }

  /**
   * Append a value to an array.
   *
   * @param mixed $value
   *
   * @return Arrayy
   */
  public function append($value)
  {
    $this->array[] = $value;

    return static::create($this->array);
  }

  /**
   * Return the array in the reverse order.
   *
   * @return Arrayy
   */
  public function reverse()
  {
    $this->array = array_reverse($this->array);

    return static::create($this->array);
  }

  /**
   * Exchanges all keys with their associated values in an array.
   *
   * @return Arrayy
   */
  public function flip()
  {
    $this->array = array_flip($this->array);

    return static::create($this->array);
  }

  /**
   * Reduce the current array via callable e.g. anonymous-function.
   *
   * @param mixed $predicate
   * @param array $init
   *
   * @return Arrayy
   */
  public function reduce($predicate, array $init = array())
  {
    $this->array = array_reduce($this->array, $predicate, $init);

It seems like array_reduce($this->array, $predicate, $init) of type * is incompatible with the declared type array of property $array.

    return static::create($this->array);
  }

  /**
   * Return a duplicate free copy of the current array.
   *
   * @return Arrayy
   */
  public function unique()
  {
    $this->array = array_reduce(

It seems like array_reduce($this->array, function ($resultArray, $value) { if (in_array($value, $resultArray, true) === false) { $resultArray[] = $value; } return $resultArray; }, array()) of type * is incompatible with the declared type array of property $array.

        $this->array,
        function ($resultArray, $value) {
          if (in_array($value, $resultArray, true) === false) {
            $resultArray[] = $value;
          }

          return $resultArray;
        },
        array()
    );

    return static::create($this->array);
  }

  /**
   * Convert the current array to JSON.
   *
   * @param null $options e.g. JSON_PRETTY_PRINT
   *
   * @return string
   */
  public function toJson($options = null)
  {
    return UTF8::json_encode($this->array, $options);
  }
}