1: <?php
2:
3: 4: 5: 6: 7: 8: 9: 10: 11:
12:
13:
14:
15: 16: 17: 18: 19:
20: final class NArrayTools
21: {
22:
23: 24: 25:
26: final public function __construct()
27: {
28: throw new LogicException("Cannot instantiate static class " . get_class($this));
29: }
30:
31:
32:
33: 34: 35: 36: 37: 38: 39: 40:
41: public static function get(array $arr, $key, $default = NULL)
42: {
43: foreach (is_array($key) ? $key : array($key) as $k) {
44: if (is_array($arr) && array_key_exists($k, $arr)) {
45: $arr = $arr[$k];
46: } else {
47: return $default;
48: }
49: }
50: return $arr;
51: }
52:
53:
54:
55: 56: 57: 58: 59: 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 InvalidArgumentException('Traversed item is not an array.');
68: }
69: }
70: return $arr;
71: }
72:
73:
74:
75: 76: 77: 78: 79: 80:
81: public static function mergeTree($arr1, $arr2)
82: {
83: $res = $arr1 + $arr2;
84: foreach (array_intersect_key($arr1, $arr2) as $k => $v) {
85: if (is_array($v) && is_array($arr2[$k])) {
86: $res[$k] = self::mergeTree($v, $arr2[$k]);
87: }
88: }
89: return $res;
90: }
91:
92:
93:
94: 95: 96: 97: 98: 99:
100: public static function searchKey($arr, $key)
101: {
102: $foo = array($key => NULL);
103: return array_search(key($foo), array_keys($arr), TRUE);
104: }
105:
106:
107:
108: 109: 110: 111: 112: 113: 114:
115: public static function insertBefore(array &$arr, $key, array $inserted)
116: {
117: $offset = self::searchKey($arr, $key);
118: $arr = array_slice($arr, 0, $offset, TRUE) + $inserted + array_slice($arr, $offset, count($arr), TRUE);
119: }
120:
121:
122:
123: 124: 125: 126: 127: 128: 129:
130: public static function insertAfter(array &$arr, $key, array $inserted)
131: {
132: $offset = self::searchKey($arr, $key);
133: $offset = $offset === FALSE ? count($arr) : $offset + 1;
134: $arr = array_slice($arr, 0, $offset, TRUE) + $inserted + array_slice($arr, $offset, count($arr), TRUE);
135: }
136:
137:
138:
139: 140: 141: 142: 143: 144: 145:
146: public static function renameKey(array &$arr, $oldKey, $newKey)
147: {
148: $offset = self::searchKey($arr, $oldKey);
149: if ($offset !== FALSE) {
150: $keys = array_keys($arr);
151: $keys[$offset] = $newKey;
152: $arr = array_combine($keys, $arr);
153: }
154: }
155:
156:
157:
158: 159: 160: 161: 162: 163: 164:
165: public static function grep(array $arr, $pattern, $flags = 0)
166: {
167: NDebug::tryError();
168: $res = preg_grep($pattern, $arr, $flags);
169: NString::catchPregError($pattern);
170: return $res;
171: }
172:
173: }