1: <?php
  2: 
  3: /**
  4:  * This file is part of the Nette Framework (https://nette.org)
  5:  * Copyright (c) 2004 David Grudl (https://davidgrudl.com)
  6:  */
  7: 
  8: namespace Nette\Utils;
  9: 
 10: use Nette;
 11: 
 12: 
 13: /**
 14:  * Array tools library.
 15:  *
 16:  * @author     David Grudl
 17:  */
 18: class Arrays
 19: {
 20: 
 21:     /**
 22:      * Static class - cannot be instantiated.
 23:      */
 24:     final public function __construct()
 25:     {
 26:         throw new Nette\StaticClassException;
 27:     }
 28: 
 29: 
 30:     /**
 31:      * Returns item from array or $default if item is not set.
 32:      * @param  array
 33:      * @param  string|int|array one or more keys
 34:      * @param  mixed
 35:      * @return mixed
 36:      * @throws Nette\InvalidArgumentException if item does not exist and default value is not provided
 37:      */
 38:     public static function get(array $arr, $key, $default = NULL)
 39:     {
 40:         foreach (is_array($key) ? $key : array($key) as $k) {
 41:             if (is_array($arr) && array_key_exists($k, $arr)) {
 42:                 $arr = $arr[$k];
 43:             } else {
 44:                 if (func_num_args() < 3) {
 45:                     throw new Nette\InvalidArgumentException("Missing item '$k'.");
 46:                 }
 47:                 return $default;
 48:             }
 49:         }
 50:         return $arr;
 51:     }
 52: 
 53: 
 54:     /**
 55:      * Returns reference to array item.
 56:      * @param  array
 57:      * @param  string|int|array one or more keys
 58:      * @return mixed
 59:      * @throws Nette\InvalidArgumentException if traversed item is not an array
 60:      */
 61:     public static function & getRef(& $arr, $key)
 62:     {
 63:         foreach (is_array($key) ? $key : array($key) as $k) {
 64:             if (is_array($arr) || $arr === NULL) {
 65:                 $arr = & $arr[$k];
 66:             } else {
 67:                 throw new Nette\InvalidArgumentException('Traversed item is not an array.');
 68:             }
 69:         }
 70:         return $arr;
 71:     }
 72: 
 73: 
 74:     /**
 75:      * Recursively appends elements of remaining keys from the second array to the first.
 76:      * @return array
 77:      */
 78:     public static function mergeTree($arr1, $arr2)
 79:     {
 80:         $res = $arr1 + $arr2;
 81:         foreach (array_intersect_key($arr1, $arr2) as $k => $v) {
 82:             if (is_array($v) && is_array($arr2[$k])) {
 83:                 $res[$k] = self::mergeTree($v, $arr2[$k]);
 84:             }
 85:         }
 86:         return $res;
 87:     }
 88: 
 89: 
 90:     /**
 91:      * Searches the array for a given key and returns the offset if successful.
 92:      * @return int|FALSE offset if it is found, FALSE otherwise
 93:      */
 94:     public static function searchKey($arr, $key)
 95:     {
 96:         $foo = array($key => NULL);
 97:         return array_search(key($foo), array_keys($arr), TRUE);
 98:     }
 99: 
100: 
101:     /**
102:      * Inserts new array before item specified by key.
103:      * @return void
104:      */
105:     public static function insertBefore(array & $arr, $key, array $inserted)
106:     {
107:         $offset = self::searchKey($arr, $key);
108:         $arr = array_slice($arr, 0, $offset, TRUE) + $inserted + array_slice($arr, $offset, count($arr), TRUE);
109:     }
110: 
111: 
112:     /**
113:      * Inserts new array after item specified by key.
114:      * @return void
115:      */
116:     public static function insertAfter(array & $arr, $key, array $inserted)
117:     {
118:         $offset = self::searchKey($arr, $key);
119:         $offset = $offset === FALSE ? count($arr) : $offset + 1;
120:         $arr = array_slice($arr, 0, $offset, TRUE) + $inserted + array_slice($arr, $offset, count($arr), TRUE);
121:     }
122: 
123: 
124:     /**
125:      * Renames key in array.
126:      * @return void
127:      */
128:     public static function renameKey(array & $arr, $oldKey, $newKey)
129:     {
130:         $offset = self::searchKey($arr, $oldKey);
131:         if ($offset !== FALSE) {
132:             $keys = array_keys($arr);
133:             $keys[$offset] = $newKey;
134:             $arr = array_combine($keys, $arr);
135:         }
136:     }
137: 
138: 
139:     /**
140:      * Returns array entries that match the pattern.
141:      * @return array
142:      */
143:     public static function grep(array $arr, $pattern, $flags = 0)
144:     {
145:         return Strings::pcre('preg_grep', array($pattern, $arr, $flags));
146:     }
147: 
148: 
149:     /**
150:      * Returns flattened array.
151:      * @return array
152:      */
153:     public static function flatten(array $arr, $preserveKeys = FALSE)
154:     {
155:         $res = array();
156:         $cb = $preserveKeys
157:             ? function ($v, $k) use (& $res) { $res[$k] = $v; }
158:             : function ($v) use (& $res) { $res[] = $v; };
159:         array_walk_recursive($arr, $cb);
160:         return $res;
161:     }
162: 
163: 
164:     /**
165:      * Finds whether a variable is a zero-based integer indexed array.
166:      * @return bool
167:      */
168:     public static function isList($value)
169:     {
170:         return is_array($value) && (!$value || array_keys($value) === range(0, count($value) - 1));
171:     }
172: 
173: }
174: