Container, fn ($min, $item) => $min === null || $itemValuePredicate($item) < $itemValuePredicate($min) ? $item : $min); } /** * Возвращает объект, значение свойства которого максимально. * * @param callable $itemValuePredicate Функция, возвращающая значение свойства объекта. * Параметром является объект массива. * * @return mixed|null Объект, значение свойства которого максимально. */ public function MaxBy (callable $itemValuePredicate): mixed { return array_reduce($this->Container, fn ($max, $item) => $max === null || $itemValuePredicate($item) > $itemValuePredicate($max) ? $item : $max); } /** * Выделяет из массива объектов объект, удовлетворяющий условию. Если объектов несколько, то выбирается первый * встречающийся объект из них. Если объектов нет, вернёт false. * * @param callable|null $selectCondition Функция выборки объектов fn (mixed $item): bool. Вместо неё * можно использовать null, тогда функция выберет текущий объект. По умолчанию, null. * * @return false|mixed Выбранный объект, удовлетворяющий условию, или false, если таких нет. */ public function GetRow (?callable $selectCondition = null): mixed { // Если условие не задано if ($selectCondition === null || !is_callable($selectCondition)) { // - то если массив не пуст if (count($this->Container) > 0) // -- возвращаем первый элемент return $this->Container[0]; else // -- иначе возвращаем false return false; } // Получаем результаты выборки из массива по условию $selectCondition $result = $this->GetRows($selectCondition); // Если результат не найден if (count($result) == 0) // - возвращаем false return false; // Возвращаем результат return $result[0]; } /** * Выделяет из массива объектов объекты, удовлетворяющие условию. * * @param callable|null $selectCondition Функция выборки объектов fn (mixed $item): bool. Вместо неё * можно использовать null, тогда функция будет выбирать все объекты. По умолчанию, null. * * @return ObjectArray Массив объектов, удовлетворяющих условию */ public function GetRows (?callable $selectCondition = null): ObjectArray { // Если условие не задано if ($selectCondition === null || !is_callable($selectCondition)) // - то возвращаем все элементы return new ObjectArray($this->Container); // Создаём результирующий массив $result = []; // Проходим по массиву foreach ($this->Container as $item) { // - пропускаем не объекты if (!is_object($item)) continue; // - если объект удовлетворяет условию if ($selectCondition($item)) // -- добавляем его в результат $result[] = $item; } // Возвращаем результат return new ObjectArray($result); } /** * Получение значение единичного поля. Если полей по выборке будет больше одного, то вернёт первое из них. * * @param string $column Требуемый столбец * @param callable|null $wherePredicate Условие выборки fn (mixed $item): bool, которое проверяет, * подходит элемент или нет. * * @return mixed|null Результат запроса или null в случае ошибки */ public function GetValue (string $column, ?callable $wherePredicate = null): mixed { // Получаю колонку $result = $this->GetColumn($column, $wherePredicate); // Если результат пуст if (count($result) == 0) // -- возвращаю null return null; // Возвращаю результат return $result[0]; } /** * Получает колонку в массиве данных. * * @param string $column Имя колонки. * @param callable|null $wherePredicate Условие выборки fn (mixed $item): bool, которое проверяет, * подходит элемент или нет. * * @return array Ассоциированный массив с результатом выборки. */ public function GetColumn (string $column, ?callable $wherePredicate = null): array { // Создаю результат $result = []; // Прохожу по массиву foreach ($this->Container as $item) { // - пропускаю не объекты if (!is_object($item)) continue; // - пропускаю не имеющие требуемого свойства if (!property_exists($item, $column)) continue; // - пропускаю не удовлетворяющие условию if ($wherePredicate !== null && !$wherePredicate($item)) continue; // - добавляю значение свойства в результат $result[] = $item->$column; } // Возвращаю результат return $result; } /** * Заменяет данные в строке\ массива. * * @param array $setItems Заменяемые элементы. * @param callable $wherePredicate Условие выборки fn (mixed $item): bool, которое проверяет, * подходит элемент или нет. * * @return bool Результат выполнения */ public function Update (array $setItems, callable $wherePredicate): bool { // Удаляю элементы $result = $this->Delete($wherePredicate); // Добавляю новые элементы foreach ($setItems as $item) $this->Container[] = $item; // Возвращаю результат return $result; } /** * Удаляет строки по условию. * * @param callable|null $wherePredicate Условие выборки fn (mixed $item): bool, которое проверяет, * подходит элемент или нет. * * @return bool Результат выполнения. Будет true, если все строки, удовлетворяющие условию удалены успешно, * иначе false. */ public function Delete (?callable $wherePredicate = null): bool { // Задаю результат $result = true; // Получаю массив строк $array = $this->GetRows($wherePredicate); // Каждый элемент в этих строках foreach ($array as $item) { // - получаю его индекс в основном массиве $key = array_search($item, $this->Container); // - и если индекс найден if ($key !== false) { // -- удаляю элемент из основного массива $resultArray = array_splice($this->Container, $key, 1); // -- и если удаление прошло успешно, то будет true $result = $result && count($resultArray) > 0; } } // Возвращаю результат return $result; } /** * Проверяет, существует ли объект в массиве. * * @param callable|null $where Условие выборки fn (mixed $item): bool, которое проверяет, подходит ли * объект или нет. Может принимать вместо замыкания null, тогда вернёт false. По умолчанию null. * * @return bool Результат проверки */ public function IsExist (?callable $where = null): bool { // Если условие не задано if ($where === null || !is_callable($where)) // - то возвращаем false return false; // Вывожу результат return $this->Count($where) > 0; } /** * Считает количество объектов в массиве, удовлетворяющих условию. * * @param callable|null $predicate Функция, возвращающая bool: true, если объект удовлетворяет условию, false, если * не удовлетворяет. Параметром является объект массива. Вместо функции можно передать null, тогда результатом * будет общее количество объектов в массиве. По умолчанию, null. * * @return int Количество объектов, удовлетворяющих условию */ public function Count (?callable $predicate = null): int { // Если условие не задано if ($predicate === null || !is_callable($predicate)) // - то возвращаем общее количество объектов return count($this->Container); // Создаём результирующее число $result = 0; // Проходим по массиву foreach ($this->Container as $item) { // - пропускаем не объекты if (!is_object($item)) continue; // - если элемент удовлетворяет условию if ($predicate($item)) // -- добавляем счётчик $result++; } // Возвращаем результат return $result; } /** * Возвращает первый элемент массива или значение по умолчанию. * * @param mixed|null $default Значение по умолчанию. По умолчанию, null. * * @return mixed|null Возвращает первый элемент массива или значение по умолчанию. */ public function First (mixed $default = null): mixed { // Получение первого элемента $firstElement = reset($this->Container); // Проверяем получение if ($firstElement === false) // - возвращаем значение по умолчанию return $default; // Возвращаем первый элемент return $firstElement; } /** * Возвращает последний элемент массива или значение по умолчанию. * * @param mixed|null $default Значение по умолчанию. По умолчанию, null. * * @return mixed|null Возвращает последний элемент массива или значение по умолчанию. */ public function Last (mixed $default = null): mixed { // Получение последнего элемента $lastElement = end($this->Container); // Проверяем получение if ($lastElement === false) // - возвращаем значение по умолчанию return $default; // Возвращаем первый элемент return $lastElement; } }