array.php ➔ index_by() - Code Metrics - Inspection of "Merge pull request #11 from equip/feature/index-by..." - equip/assist - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Push — master ( f24d65...38d877 )

by Woody

created 2016-06-24 14:36 UTC

array.php ➔ index_by() A

↳ Parent: Project

Complexity

Conditions	3
Paths	3

Size

Total Lines	14
Code Lines	8

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	6
CRAP Score	3

Importance

Changes	1
Bugs	0	Features	1

Metric	Value
cc	3
eloc	8
c	1
b	0
f	1
nc	3
nop	2
dl	0
loc	14
ccs	6
cts	6
cp	1
crap	3
rs	9.4285

<?php

namespace Equip\Arr;

use Traversable;

/**
 * Check if a key exists in an array.
 *
 * @param array|Traversable $array
 * @param string|integer $key
 *
 * @return boolean
 */
function exists($array, $key)
{
    return array_key_exists($key, to_array($array));
}

/**
 * Convert a value to an array.
 *
 * If the value is an array it will be returned.
 * If the value is Traversable it will be converted to an array.
 * If the value is anything else it will be cast to an array.
 *
 * @param mixed $value
 *
 * @return array
 */
function to_array($value)

{
    if (is_array($value)) {
        return $value;
    }

    if ($value instanceof Traversable) {
        return iterator_to_array($value);
    }

    return (array) $value;
}

/**
 * Get a single value from an array.
 *
 * If the value does not exist, the default will be returned.
 *
 * @param array|Traversable $source
 * @param string|integer $key
 * @param mixed $default
 *
 * @return mixed
 */
function get($source, $key, $default = null)
{
    if (exists($source, $key)) {
        return $source[$key];
    }

    return $default;
}

/**
 * Grab some values from an array.
 *
 * @param array|Traversable $source
 * @param array|string $keys
 *
 * @return array
 */
function some($source, $keys)
{
    return array_intersect_key(
        to_array($source),
        array_flip(to_array($keys))
    );
}

/**
 * Exclude some values from an array.
 *
 * This is the inverse of some().
 *
 * @param array|Traversable $source
 * @param array|string $keys
 *
 * @return array
 */
function without($source, $keys)
{
    return array_diff_key(
        to_array($source),
        array_flip(to_array($keys))
    );
}

/**
 * Take the first value from an array.
 *
 * @param array $list
 *
 * @return mixed
 */
function head($list)
{
    $list = to_array($list);
    return array_shift($list);
}

/**
 * Take the last value from an array.
 *
 * @param array $list
 *
 * @return mixed
 */
function tail($list)
{
    $list = to_array($list);
    return array_pop($list);
}

/**
 * Index an collection by a key.
 *
 * Rows in the collection can be arrays or objects.
 *
 * @param array|Traversable $source
 *
 * @return array
 */
function index_by($source, $key)

{
    $indexed = [];

    foreach ($source as $row) {
        if (is_object($row)) {
            $indexed[$row->$key] = $row;
        } else {
            $indexed[$row[$key]] = $row;
        }
    }

    return $indexed;
}


1		<?php
2
3		namespace Equip\Arr;
4
5		use Traversable;
6
7		/**
8		* Check if a key exists in an array.
9		*
10		* @param array\|Traversable $array
11		* @param string\|integer $key
12		*
13		* @return boolean
14		*/
15		function exists($array, $key)
16		{
17	1	return array_key_exists($key, to_array($array));
18		}
19
20		/**
21		* Convert a value to an array.
22		*
23		* If the value is an array it will be returned.
24		* If the value is Traversable it will be converted to an array.
25		* If the value is anything else it will be cast to an array.
26		*
27		* @param mixed $value
28		*
29		* @return array
30		*/
31		function to_array($value)
		0 ignored issues – show Coding Style introduced 2016-03-22 01:10 UTC by Report Bug Copy Issue Report As per coding-style, this function should be in camelCase. CamelCase (...) is the practice of writing compound words or phrases such that each word or abbreviation begins with a capital letter. Learn more about camelCase. Loading history...
32		{
33	6	if (is_array($value)) {
34	6	return $value;
35		}
36
37	3	if ($value instanceof Traversable) {
38	1	return iterator_to_array($value);
39		}
40
41	3	return (array) $value;
42		}
43
44		/**
45		* Get a single value from an array.
46		*
47		* If the value does not exist, the default will be returned.
48		*
49		* @param array\|Traversable $source
50		* @param string\|integer $key
51		* @param mixed $default
52		*
53		* @return mixed
54		*/
55		function get($source, $key, $default = null)
56		{
57	1	if (exists($source, $key)) {
58	1	return $source[$key];
59		}
60
61	1	return $default;
62		}
63
64		/**
65		* Grab some values from an array.
66		*
67		* @param array\|Traversable $source
68		* @param array\|string $keys
69		*
70		* @return array
71		*/
72		function some($source, $keys)
73		{
74	1	return array_intersect_key(
75		to_array($source),
76		array_flip(to_array($keys))
77		);
78		}
79
80		/**
81		* Exclude some values from an array.
82		*
83		* This is the inverse of some().
84		*
85		* @param array\|Traversable $source
86		* @param array\|string $keys
87		*
88		* @return array
89		*/
90		function without($source, $keys)
91		{
92	1	return array_diff_key(
93		to_array($source),
94		array_flip(to_array($keys))
95		);
96		}
97
98		/**
99		* Take the first value from an array.
100		*
101		* @param array $list
102		*
103		* @return mixed
104		*/
105		function head($list)
106		{
107	1	$list = to_array($list);
108	1	return array_shift($list);
109		}
110
111		/**
112		* Take the last value from an array.
113		*
114		* @param array $list
115		*
116		* @return mixed
117		*/
118		function tail($list)
119		{
120	1	$list = to_array($list);
121	1	return array_pop($list);
122		}
123
124		/**
125		* Index an collection by a key.
126		*
127		* Rows in the collection can be arrays or objects.
128		*
129		* @param array\|Traversable $source
130		*
131		* @return array
132		*/
133		function index_by($source, $key)
		0 ignored issues – show Coding Style introduced 2016-06-23 15:14 UTC by Report Bug Copy Issue Report As per coding-style, this function should be in camelCase. CamelCase (...) is the practice of writing compound words or phrases such that each word or abbreviation begins with a capital letter. Learn more about camelCase. Loading history...
134		{
135	1	$indexed = [];
136
137	1	foreach ($source as $row) {
138	1	if (is_object($row)) {
139	1	$indexed[$row->$key] = $row;
140		} else {
141	1	$indexed[$row[$key]] = $row;
142		}
143		}
144
145	1	return $indexed;
146		}
147

equip / assist

Push — master ( f24d65...38d877 )

array.php ➔ index_by() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like