SimpleArrayLibrary::hasAllValuesMultiDimensional() - Code Metrics - Inspection of "Has all values multidimensional method prepared" - ajant/SimpleArrayLibrary - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Push — master ( 34f5b0...95bb8d )

by Aleksandar

created 2015-12-09 18:01 UTC

SimpleArrayLibrary::hasAllValuesMultiDimensional() A

↳ Parent: SimpleArrayLibrary

Complexity

Conditions	3
Paths	3

Size

Total Lines	12
Code Lines	7

Duplication

Lines	0
Ratio	0 %

Importance

Changes	1
Bugs	0	Features	0

Metric	Value
c	1
b	0
f	0
dl	0
loc	12
rs	9.4286
cc	3
eloc	7
nc	3
nop	2

<?php

namespace SimpleArrayLibrary;

use InvalidArgumentException;
use UnexpectedValueException;

class SimpleArrayLibrary
{
    /**
     * @param array $config
     * @param array $keys
     * @param mixed $value
     *
     * @return array
     */
    public static function addConfigRow(array $config, array $keys, $value)
    {
        // validation
        if (self::isAssociative($keys)) {
            throw new UnexpectedValueException('Array of config keys must be numeric');
        }

        $row = $value;
        for ($i = count($keys) - 1; $i >= 0; $i--) {
            $row = [$keys[$i] => $row];
        }
        $config = self::insertSubArray($config, $row);

        return $config;
    }

    /**
     * Checks if all elements of the array have same value
     *
     * @param array $haystack
     * @param mixed $needle
     *
     * @return boolean
     */
    public static function allElementsEqual(array $haystack, $needle = null)
    {
        $return = true;
        // if both arguments have been passed, use value argument (regardless of whether it is null or not
        if (func_num_args() == 2) {
            $compareAgainst = $needle;
        } // only one argument has been passed, so compare elements only to each other
        else {
            $compareAgainst = reset($haystack);
        }
        foreach ($haystack as $element) {
            if ($compareAgainst != $element) {
                $return = false;
                break;
            }
        }

        return $return;
    }

    const TYPE_INT = 'int';
    const TYPE_STRING = 'string';
    const TYPE_FLOAT = 'float';
    const TYPE_BOOL = 'bool';
    const TYPE_ARRAY = 'array';
    const TYPE_OBJECT = 'object';

    /**
     * @param array $matrix
     * @param array $castMap
     * @param bool  $allKeysMustBePresent
     *
     * @return array
     */
    public static function castColumns(array $matrix, array $castMap, $allKeysMustBePresent = true)
    {
        if (!is_bool($allKeysMustBePresent)) {
            throw new InvalidArgumentException('Third parameter must be a boolean');
        }
        if (empty($matrix)) {
            return $matrix;
        }
        if (self::countMinDepth($matrix) < 2) {
            throw new UnexpectedValueException('Can not cast columns on one dimensional array');
        }

        foreach ($matrix as $key => $row) {
            foreach ($castMap as $column => $type) {
                if (isset($row[$column]) || array_key_exists($column, $row)) {
                    switch ($type) {
                        case self::TYPE_INT:
                            $matrix[$key][$column] = (int)$row[$column];
                            break;
                        case self::TYPE_STRING:
                            $matrix[$key][$column] = (string)$row[$column];
                            break;
                        case self::TYPE_FLOAT:
                            $matrix[$key][$column] = (float)$row[$column];
                            break;
                        case self::TYPE_BOOL:
                            $matrix[$key][$column] = (bool)$row[$column];
                            break;
                        case self::TYPE_ARRAY:
                            $matrix[$key][$column] = (array)$row[$column];
                            break;
                        case self::TYPE_OBJECT:
                            $matrix[$key][$column] = (object)$row[$column];
                            break;
                        default:
                            throw new UnexpectedValueException('Invalid type: ' . $type);
                    }
                } elseif ($allKeysMustBePresent) {
                    throw new UnexpectedValueException('Column: ' . $column . ' missing in row: ' . $key);
                }
            }
        }

        return $matrix;
    }

    /**
     * Counts maximum array depth recursively
     *
     * @param array $array
     *
     * @return int
     */
    public static function countMaxDepth(array $array)
    {
        $maxDepth = 1;
        foreach ($array as $element) {
            $depth = 1;
            if (is_array($element)) {
                $depth += self::countMaxDepth($element);
            }
            if ($depth > $maxDepth) $maxDepth = $depth;
        }

        return $maxDepth;
    }

    /**
     * Counts maximum array depth iteratively
     *
     * @param array $array
     *
     * @return int
     */
    public static function countMaxDepthIterative(array $array)
    {
        $copy     = $array;
        $maxDepth = 1;

        foreach ($copy as $element) {
            $depth = 1;
            while (!empty($element)) {
                if (is_array($element)) {
                    ++$depth;
                    $tmp = array_shift($element);
                    if (is_array($tmp)) {
                        array_push($element, array_shift($tmp));
                    }
                } else {
                    break;
                }
            }
            if ($depth > $maxDepth) {
                $maxDepth = $depth;
            }
        }

        return $maxDepth;
    }

    /**
     * Counts maximum array depth
     *
     * @param mixed $potentialArray
     * @param int   $depth
     *
     * @return int
     * @throws InvalidArgumentException
     */
    public static function countMinDepth($potentialArray, $depth = 0)
    {
        // validation, must be positive int or 0
        if (!self::isLogicallyCastableToInt($depth)) {
            throw new InvalidArgumentException('Depth parameter must be non-negative integer');
        }
        if ($depth < 0) {
            throw new InvalidArgumentException('Depth parameter must be non-negative integer');
        }

        $return = $depth;
        if (is_array($potentialArray)) {
            $return++;
            $childrenDepths = array();
            foreach ($potentialArray as $element) {
                $childrenDepths[] = self::countMinDepth($element, $return);
            }
            $return = empty($childrenDepths) ? $return : min($childrenDepths);
        }

        return $return;
    }

    /**
     * @param array $matrix
     * @param mixed $columns
     *
     * @return array
     */
    public static function deleteColumns(array $matrix, array $columns)
    {
        // validate input
        if (self::countMinDepth($matrix) < 2) {
            throw new UnexpectedValueException('Can not delete columns on one dimensional array');
        }
        if (self::countMinDepth($columns) != 1) {
            throw new InvalidArgumentException('Invalid column');
        }

        // remove columns in every row
        foreach ($matrix as $key => $row) {
            foreach ($columns as $column) {
                unset($matrix[$key][$column]);
            }
        }

        return $matrix;
    }

    /**
     * Extracts a column from an array
     *
     * @param array $array
     * @param array $columns
     * @param bool  $allRowsMustHaveAllColumns
     *
     * @return array
     * @throws UnexpectedValueException
     */
    public static function getColumns(array $array, array $columns, $allRowsMustHaveAllColumns = false)
    {
        // validation
        foreach ($array as $key => $row) {
            if (!is_array($row)) {
                throw new UnexpectedValueException('Array element "' . $key . '" is not an array');
            }
        }
        foreach ($columns as $key => $column) {
            if (!is_string($column) && !is_numeric($column)) {
                throw new InvalidArgumentException('Invalid column type in columns array, index "' . $key . '"');
            }
        }
        if (!is_bool($allRowsMustHaveAllColumns)) {
            throw new InvalidArgumentException('allRowsMustHaveAllColumns flag must be boolean');
        }

        $return = array_fill_keys($columns, array());
        foreach ($array as $key => $row) {
            foreach ($columns as $column) {
                if (isset($row[$column]) || array_key_exists($column, $row)) {
                    $return[$column][$key] = $row[$column];
                } elseif ($allRowsMustHaveAllColumns) {
                    throw new UnexpectedValueException('Row "' . $key . '" is missing column: "' . $column . '"');
                }
            }
        }

        return $return;
    }

    /**
     * Checks if an array is rectangular array and returns dimensions or -1 if it's not rectangular
     *
     * @param array $array
     *
     * @return int|array
     */
    public static function getRectangularDimensions(array $array)
    {
        $return = -1;
        $allArrays = array_map('is_array', $array);
        // all elements are arrays, iterate through them and call the static function recursively
        if (self::allElementsEqual($allArrays, true)) {
            $elementsPerArray = array();
            foreach ($array as $row) {
                $noElements = self::getRectangularDimensions($row);
                if ($noElements == -1) {
                    return $noElements;
                }
                $elementsPerArray[] = $noElements;
            }
            if (!self::allElementsEqual($elementsPerArray)) {
                return -1;
            } else {
                $return   = reset($elementsPerArray);
                $return[] = count($elementsPerArray);
            }
        } // none of the elements are arrays, return number of elements of the "bottom" array
        elseif (self::allElementsEqual($allArrays, false)) {
            $return = array(0 => count($array));
        }

        return $return;
    }

    /**
     * Checks if $array's keys contain all of $subArray's values
     *
     * @param array $haystack
     * @param array $needles
     *
     * @return bool
     */
    public static function hasAllKeys(array $haystack, array $needles)
    {
        return self::hasAllValues(array_keys($haystack), $needles);
    }

    /**
     * Checks if $array's keys contain all of $subArray's values
     *
     * @param array $haystack
     * @param array $needles
     *
     * @return bool
     */
    public static function hasAllValues(array $haystack, array $needles)
    {
        return array_diff($needles, $haystack) ? false : true;
    }

    /**
     * Checks if $array's keys contain all of $subArray's values
     *
     * @param array $haystack
     * @param array $needles
     *
     * @return bool
     */
    public static function hasAllValuesMultiDimensional(array $haystack, array $needles)
    {
        $return = true;
        foreach ($needles as $needle) {
            if (!in_array($needle, $haystack)) {
                $return = false;
                break;
            }
        }

        return $return;
    }

    /**
     * Checks whether array has only provided keys as indexes
     *
     * @param array $haystack
     * @param array $needles
     *
     * @return bool
     */
    public static function hasOnlyKeys(array $haystack, array $needles)
    {
        return self::haveSameKeys($haystack, array_flip($needles));
    }

    /**
     * Checks if two arrays have all equal keys
     *
     * @param array $array1
     * @param array $array2
     *
     * @return boolean
     */
    public static function haveSameKeys(array $array1, array $array2)
    {
        return self::hasAllKeys($array1, array_keys($array2)) && self::hasAllKeys($array2, array_keys($array1)) ? true : false;
    }

    /**
     * Check if two arrays have all equal values
     *
     * @param array $array1
     * @param array $array2
     *
     * @return bool
     */
    public static function haveSameValues($array1, $array2)
    {
        return self::hasAllValues($array1, $array2) && self::hasAllValues($array2, $array1) ? true : false;
    }

    /**
     * @param mixed $array
     * @param mixed $subArray
     * @param bool  $overwrite
     * @param bool  $ignoreIfExists
     *
     * @return array
     */
    public static function insertSubArray($array, $subArray, $overwrite = false, $ignoreIfExists = false)
    {
        // validate
        if (!is_bool($overwrite)) {
            throw new InvalidArgumentException('Overwrite indicator must be a boolean');
        }
        if (!is_bool($ignoreIfExists)) {
            throw new InvalidArgumentException('Ignore if exists indicator must be a boolean');
        }

        if (!is_array($subArray) || !is_array($array)) {
            // $subArray[$key] is leaf of the array
            if ($overwrite) {
                $array = $subArray;
            } elseif (!$ignoreIfExists) {
                throw new UnexpectedValueException('Sub-array already exists');
            }
        } else {
            $key = key($subArray);
            if (isset($array[$key]) || array_key_exists($key, $array)) {
                $array[$key] = self::insertSubArray($array[$key], $subArray[$key], $overwrite, $ignoreIfExists);
            } else {
                $array[$key] = $subArray[$key];
            }
        }

        return $array;
    }

    /**
     * Checks whether array is associative or numeric
     *
     * @param array $array
     *
     * @return bool
     */
    public static function isAssociative(array $array)
    {
        return (bool)count(array_filter(array_keys($array), 'is_string'));
    }

    /**
     * Checks whether $subArray is contained in $array
     *
     * @param array $array
     * @param array $subArray
     * @param bool  $strictComparison
     *
     * @return bool
     * @throws InvalidArgumentException
     */
    public static function isSubArray(array $array, array $subArray, $strictComparison = true)
    {
        if (!is_bool($strictComparison)) {
            throw new InvalidArgumentException('Strict comparison parameter must be a boolean');
        }

        $return = true;
        foreach ($subArray as $key => $value) {
            if (isset($array[$key]) || array_key_exists($key, $array)) {
                $check = $strictComparison ? $array[$key] !== $subArray[$key] : $array[$key] != $subArray[$key];
                if ($check) {
                    $return = false;
                    break;
                }
            } else {
                $return = false;
                break;
            }
        }

        return $return;
    }

    /**
     * Selects random sub array
     *
     * @param array $array
     * @param int $numberOfRequiredElements
     *
     * @return array
     * @throws InvalidArgumentException
     */
    public static function selectRandomArrayElements(array $array, $numberOfRequiredElements)
    {
        // validation, must be positive int or 0
        if (!self::isLogicallyCastableToInt($numberOfRequiredElements)) {
            throw new InvalidArgumentException('Number of requested elements parameter must be a positive integer');
        }
        if ($numberOfRequiredElements <= 0) {
            throw new InvalidArgumentException('Number of requested elements parameter must be a positive integer');
        }

        $selected = $array;
        if (count($array) > $numberOfRequiredElements) {
            // select required number of random keys
            $selectedKeys = array_rand($array, $numberOfRequiredElements);
            $selectedKeys = $numberOfRequiredElements == 1 ? [$selectedKeys] : $selectedKeys;
            // select only array members with selected random keys
            $selected = array_intersect_key($array, array_fill_keys($selectedKeys, null));
        }

        return $selected;
    }

    /**
     * @param array $matrix
     * @param mixed $column
     * @param mixed $value
     * @param bool  $insertIfMissing
     * @param bool  $overwrite
     *
     * @return array
     */
    public static function setColumn(array $matrix, $column, $value, $insertIfMissing = true, $overwrite = true)
    {
        // validate input
        if (self::countMinDepth($matrix) < 2) {
            throw new UnexpectedValueException('Can not set columns on one dimensional array');
        }
        if (!is_scalar($column)) {
            throw new InvalidArgumentException('Invalid column');
        }
        if (!is_bool($insertIfMissing)) {
            throw new InvalidArgumentException('Insert if missing indicator must be a boolean');
        }
        if (!is_bool($overwrite)) {
            throw new InvalidArgumentException('Overwrite indicator must be a boolean');
        }

        foreach ($matrix as $key => $row) {
            if (isset($row[$column]) || array_key_exists($column, $row)) {
                $matrix[$key][$column] = ($overwrite ? $value : $matrix[$key][$column]);
            } elseif ($insertIfMissing) {
                $matrix[$key][$column] = $value;
            }
        }

        return $matrix;
    }

    /**
     * Check whether casting a variable to int would conway useful information
     *
     * @param mixed $input
     *
     * @return bool
     */
    private static function isLogicallyCastableToInt($input)
    {
        return !is_bool($input) && filter_var($input, FILTER_VALIDATE_INT) !== false;
    }
}

1			<?php
2
3			namespace SimpleArrayLibrary;
4
5			use InvalidArgumentException;
6			use UnexpectedValueException;
7
8			class SimpleArrayLibrary
9			{
10			/**
11			* @param array $config
12			* @param array $keys
13			* @param mixed $value
14			*
15			* @return array
16			*/
17			public static function addConfigRow(array $config, array $keys, $value)
18			{
19			// validation
20			if (self::isAssociative($keys)) {
21			throw new UnexpectedValueException('Array of config keys must be numeric');
22			}
23
24			$row = $value;
25			for ($i = count($keys) - 1; $i >= 0; $i--) {
26			$row = [$keys[$i] => $row];
27			}
28			$config = self::insertSubArray($config, $row);
29
30			return $config;
31			}
32
33			/**
34			* Checks if all elements of the array have same value
35			*
36			* @param array $haystack
37			* @param mixed $needle
38			*
39			* @return boolean
40			*/
41			public static function allElementsEqual(array $haystack, $needle = null)
42			{
43			$return = true;
44			// if both arguments have been passed, use value argument (regardless of whether it is null or not
45			if (func_num_args() == 2) {
46			$compareAgainst = $needle;
47			} // only one argument has been passed, so compare elements only to each other
48			else {
49			$compareAgainst = reset($haystack);
50			}
51			foreach ($haystack as $element) {
52			if ($compareAgainst != $element) {
53			$return = false;
54			break;
55			}
56			}
57
58			return $return;
59			}
60
61			const TYPE_INT = 'int';
62			const TYPE_STRING = 'string';
63			const TYPE_FLOAT = 'float';
64			const TYPE_BOOL = 'bool';
65			const TYPE_ARRAY = 'array';
66			const TYPE_OBJECT = 'object';
67
68			/**
69			* @param array $matrix
70			* @param array $castMap
71			* @param bool $allKeysMustBePresent
72			*
73			* @return array
74			*/
75			public static function castColumns(array $matrix, array $castMap, $allKeysMustBePresent = true)
76			{
77			if (!is_bool($allKeysMustBePresent)) {
78			throw new InvalidArgumentException('Third parameter must be a boolean');
79			}
80			if (empty($matrix)) {
81			return $matrix;
82			}
83			if (self::countMinDepth($matrix) < 2) {
84			throw new UnexpectedValueException('Can not cast columns on one dimensional array');
85			}
86
87			foreach ($matrix as $key => $row) {
88			foreach ($castMap as $column => $type) {
89			if (isset($row[$column]) \|\| array_key_exists($column, $row)) {
90			switch ($type) {
91			case self::TYPE_INT:
92			$matrix[$key][$column] = (int)$row[$column];
93			break;
94			case self::TYPE_STRING:
95			$matrix[$key][$column] = (string)$row[$column];
96			break;
97			case self::TYPE_FLOAT:
98			$matrix[$key][$column] = (float)$row[$column];
99			break;
100			case self::TYPE_BOOL:
101			$matrix[$key][$column] = (bool)$row[$column];
102			break;
103			case self::TYPE_ARRAY:
104			$matrix[$key][$column] = (array)$row[$column];
105			break;
106			case self::TYPE_OBJECT:
107			$matrix[$key][$column] = (object)$row[$column];
108			break;
109			default:
110			throw new UnexpectedValueException('Invalid type: ' . $type);
111			}
112			} elseif ($allKeysMustBePresent) {
113			throw new UnexpectedValueException('Column: ' . $column . ' missing in row: ' . $key);
114			}
115			}
116			}
117
118			return $matrix;
119			}
120
121			/**
122			* Counts maximum array depth recursively
123			*
124			* @param array $array
125			*
126			* @return int
127			*/
128			public static function countMaxDepth(array $array)
129			{
130			$maxDepth = 1;
131			foreach ($array as $element) {
132			$depth = 1;
133			if (is_array($element)) {
134			$depth += self::countMaxDepth($element);
135			}
136			if ($depth > $maxDepth) $maxDepth = $depth;
137			}
138
139			return $maxDepth;
140			}
141
142			/**
143			* Counts maximum array depth iteratively
144			*
145			* @param array $array
146			*
147			* @return int
148			*/
149			public static function countMaxDepthIterative(array $array)
150			{
151			$copy = $array;
152			$maxDepth = 1;
153
154			foreach ($copy as $element) {
155			$depth = 1;
156			while (!empty($element)) {
157			if (is_array($element)) {
158			++$depth;
159			$tmp = array_shift($element);
160			if (is_array($tmp)) {
161			array_push($element, array_shift($tmp));
162			}
163			} else {
164			break;
165			}
166			}
167			if ($depth > $maxDepth) {
168			$maxDepth = $depth;
169			}
170			}
171
172			return $maxDepth;
173			}
174
175			/**
176			* Counts maximum array depth
177			*
178			* @param mixed $potentialArray
179			* @param int $depth
180			*
181			* @return int
182			* @throws InvalidArgumentException
183			*/
184			public static function countMinDepth($potentialArray, $depth = 0)
185			{
186			// validation, must be positive int or 0
187			if (!self::isLogicallyCastableToInt($depth)) {
188			throw new InvalidArgumentException('Depth parameter must be non-negative integer');
189			}
190			if ($depth < 0) {
191			throw new InvalidArgumentException('Depth parameter must be non-negative integer');
192			}
193
194			$return = $depth;
195			if (is_array($potentialArray)) {
196			$return++;
197			$childrenDepths = array();
198			foreach ($potentialArray as $element) {
199			$childrenDepths[] = self::countMinDepth($element, $return);
200			}
201			$return = empty($childrenDepths) ? $return : min($childrenDepths);
202			}
203
204			return $return;
205			}
206
207			/**
208			* @param array $matrix
209			* @param mixed $columns
210			*
211			* @return array
212			*/
213			public static function deleteColumns(array $matrix, array $columns)
214			{
215			// validate input
216			if (self::countMinDepth($matrix) < 2) {
217			throw new UnexpectedValueException('Can not delete columns on one dimensional array');
218			}
219			if (self::countMinDepth($columns) != 1) {
220			throw new InvalidArgumentException('Invalid column');
221			}
222
223			// remove columns in every row
224			foreach ($matrix as $key => $row) {
225			foreach ($columns as $column) {
226			unset($matrix[$key][$column]);
227			}
228			}
229
230			return $matrix;
231			}
232
233			/**
234			* Extracts a column from an array
235			*
236			* @param array $array
237			* @param array $columns
238			* @param bool $allRowsMustHaveAllColumns
239			*
240			* @return array
241			* @throws UnexpectedValueException
242			*/
243			public static function getColumns(array $array, array $columns, $allRowsMustHaveAllColumns = false)
244			{
245			// validation
246			foreach ($array as $key => $row) {
247			if (!is_array($row)) {
248			throw new UnexpectedValueException('Array element "' . $key . '" is not an array');
249			}
250			}
251			foreach ($columns as $key => $column) {
252			if (!is_string($column) && !is_numeric($column)) {
253			throw new InvalidArgumentException('Invalid column type in columns array, index "' . $key . '"');
254			}
255			}
256			if (!is_bool($allRowsMustHaveAllColumns)) {
257			throw new InvalidArgumentException('allRowsMustHaveAllColumns flag must be boolean');
258			}
259
260			$return = array_fill_keys($columns, array());
261			foreach ($array as $key => $row) {
262			foreach ($columns as $column) {
263			if (isset($row[$column]) \|\| array_key_exists($column, $row)) {
264			$return[$column][$key] = $row[$column];
265			} elseif ($allRowsMustHaveAllColumns) {
266			throw new UnexpectedValueException('Row "' . $key . '" is missing column: "' . $column . '"');
267			}
268			}
269			}
270
271			return $return;
272			}
273
274			/**
275			* Checks if an array is rectangular array and returns dimensions or -1 if it's not rectangular
276			*
277			* @param array $array
278			*
279			* @return int\|array
280			*/
281			public static function getRectangularDimensions(array $array)
282			{
283			$return = -1;
284			$allArrays = array_map('is_array', $array);
285			// all elements are arrays, iterate through them and call the static function recursively
286			if (self::allElementsEqual($allArrays, true)) {
287			$elementsPerArray = array();
288			foreach ($array as $row) {
289			$noElements = self::getRectangularDimensions($row);
290			if ($noElements == -1) {
291			return $noElements;
292			}
293			$elementsPerArray[] = $noElements;
294			}
295			if (!self::allElementsEqual($elementsPerArray)) {
296			return -1;
297			} else {
298			$return = reset($elementsPerArray);
299			$return[] = count($elementsPerArray);
300			}
301			} // none of the elements are arrays, return number of elements of the "bottom" array
302			elseif (self::allElementsEqual($allArrays, false)) {
303			$return = array(0 => count($array));
304			}
305
306			return $return;
307			}
308
309			/**
310			* Checks if $array's keys contain all of $subArray's values
311			*
312			* @param array $haystack
313			* @param array $needles
314			*
315			* @return bool
316			*/
317			public static function hasAllKeys(array $haystack, array $needles)
318			{
319			return self::hasAllValues(array_keys($haystack), $needles);
320			}
321
322			/**
323			* Checks if $array's keys contain all of $subArray's values
324			*
325			* @param array $haystack
326			* @param array $needles
327			*
328			* @return bool
329			*/
330			public static function hasAllValues(array $haystack, array $needles)
331			{
332			return array_diff($needles, $haystack) ? false : true;
333			}
334
335			/**
336			* Checks if $array's keys contain all of $subArray's values
337			*
338			* @param array $haystack
339			* @param array $needles
340			*
341			* @return bool
342			*/
343			public static function hasAllValuesMultiDimensional(array $haystack, array $needles)
344			{
345			$return = true;
346			foreach ($needles as $needle) {
347			if (!in_array($needle, $haystack)) {
348			$return = false;
349			break;
350			}
351			}
352
353			return $return;
354			}
355
356			/**
357			* Checks whether array has only provided keys as indexes
358			*
359			* @param array $haystack
360			* @param array $needles
361			*
362			* @return bool
363			*/
364			public static function hasOnlyKeys(array $haystack, array $needles)
365			{
366			return self::haveSameKeys($haystack, array_flip($needles));
367			}
368
369			/**
370			* Checks if two arrays have all equal keys
371			*
372			* @param array $array1
373			* @param array $array2
374			*
375			* @return boolean
376			*/
377			public static function haveSameKeys(array $array1, array $array2)
378			{
379			return self::hasAllKeys($array1, array_keys($array2)) && self::hasAllKeys($array2, array_keys($array1)) ? true : false;
380			}
381
382			/**
383			* Check if two arrays have all equal values
384			*
385			* @param array $array1
386			* @param array $array2
387			*
388			* @return bool
389			*/
390			public static function haveSameValues($array1, $array2)
391			{
392			return self::hasAllValues($array1, $array2) && self::hasAllValues($array2, $array1) ? true : false;
393			}
394
395			/**
396			* @param mixed $array
397			* @param mixed $subArray
398			* @param bool $overwrite
399			* @param bool $ignoreIfExists
400			*
401			* @return array
402			*/
403			public static function insertSubArray($array, $subArray, $overwrite = false, $ignoreIfExists = false)
404			{
405			// validate
406			if (!is_bool($overwrite)) {
407			throw new InvalidArgumentException('Overwrite indicator must be a boolean');
408			}
409			if (!is_bool($ignoreIfExists)) {
410			throw new InvalidArgumentException('Ignore if exists indicator must be a boolean');
411			}
412
413			if (!is_array($subArray) \|\| !is_array($array)) {
414			// $subArray[$key] is leaf of the array
415			if ($overwrite) {
416			$array = $subArray;
417			} elseif (!$ignoreIfExists) {
418			throw new UnexpectedValueException('Sub-array already exists');
419			}
420			} else {
421			$key = key($subArray);
422			if (isset($array[$key]) \|\| array_key_exists($key, $array)) {
423			$array[$key] = self::insertSubArray($array[$key], $subArray[$key], $overwrite, $ignoreIfExists);
424			} else {
425			$array[$key] = $subArray[$key];
426			}
427			}
428
429			return $array;
430			}
431
432			/**
433			* Checks whether array is associative or numeric
434			*
435			* @param array $array
436			*
437			* @return bool
438			*/
439			public static function isAssociative(array $array)
440			{
441			return (bool)count(array_filter(array_keys($array), 'is_string'));
442			}
443
444			/**
445			* Checks whether $subArray is contained in $array
446			*
447			* @param array $array
448			* @param array $subArray
449			* @param bool $strictComparison
450			*
451			* @return bool
452			* @throws InvalidArgumentException
453			*/
454			public static function isSubArray(array $array, array $subArray, $strictComparison = true)
455			{
456			if (!is_bool($strictComparison)) {
457			throw new InvalidArgumentException('Strict comparison parameter must be a boolean');
458			}
459
460			$return = true;
461			foreach ($subArray as $key => $value) {
462			if (isset($array[$key]) \|\| array_key_exists($key, $array)) {
463			$check = $strictComparison ? $array[$key] !== $subArray[$key] : $array[$key] != $subArray[$key];
464			if ($check) {
465			$return = false;
466			break;
467			}
468			} else {
469			$return = false;
470			break;
471			}
472			}
473
474			return $return;
475			}
476
477			/**
478			* Selects random sub array
479			*
480			* @param array $array
481			* @param int $numberOfRequiredElements
482			*
483			* @return array
484			* @throws InvalidArgumentException
485			*/
486			public static function selectRandomArrayElements(array $array, $numberOfRequiredElements)
487			{
488			// validation, must be positive int or 0
489			if (!self::isLogicallyCastableToInt($numberOfRequiredElements)) {
490			throw new InvalidArgumentException('Number of requested elements parameter must be a positive integer');
491			}
492			if ($numberOfRequiredElements <= 0) {
493			throw new InvalidArgumentException('Number of requested elements parameter must be a positive integer');
494			}
495
496			$selected = $array;
497			if (count($array) > $numberOfRequiredElements) {
498			// select required number of random keys
499			$selectedKeys = array_rand($array, $numberOfRequiredElements);
500			$selectedKeys = $numberOfRequiredElements == 1 ? [$selectedKeys] : $selectedKeys;
501			// select only array members with selected random keys
502			$selected = array_intersect_key($array, array_fill_keys($selectedKeys, null));
503			}
504
505			return $selected;
506			}
507
508			/**
509			* @param array $matrix
510			* @param mixed $column
511			* @param mixed $value
512			* @param bool $insertIfMissing
513			* @param bool $overwrite
514			*
515			* @return array
516			*/
517			public static function setColumn(array $matrix, $column, $value, $insertIfMissing = true, $overwrite = true)
518			{
519			// validate input
520			if (self::countMinDepth($matrix) < 2) {
521			throw new UnexpectedValueException('Can not set columns on one dimensional array');
522			}
523			if (!is_scalar($column)) {
524			throw new InvalidArgumentException('Invalid column');
525			}
526			if (!is_bool($insertIfMissing)) {
527			throw new InvalidArgumentException('Insert if missing indicator must be a boolean');
528			}
529			if (!is_bool($overwrite)) {
530			throw new InvalidArgumentException('Overwrite indicator must be a boolean');
531			}
532
533			foreach ($matrix as $key => $row) {
534			if (isset($row[$column]) \|\| array_key_exists($column, $row)) {
535			$matrix[$key][$column] = ($overwrite ? $value : $matrix[$key][$column]);
536			} elseif ($insertIfMissing) {
537			$matrix[$key][$column] = $value;
538			}
539			}
540
541			return $matrix;
542			}
543
544			/**
545			* Check whether casting a variable to int would conway useful information
546			*
547			* @param mixed $input
548			*
549			* @return bool
550			*/
551			private static function isLogicallyCastableToInt($input)
552			{
553			return !is_bool($input) && filter_var($input, FILTER_VALIDATE_INT) !== false;
554			}
555			}

ajant / SimpleArrayLibrary

Push — master ( 34f5b0...95bb8d )

SimpleArrayLibrary::hasAllValuesMultiDimensional() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like