Merge remote-tracking branch 'origin/master'

+ [ObjectArray]: Добавлена функция First для получения первого объекта из массива объектов.

+ [ObjectArray]: Добавлена функция Last для получения последнего объекта из массива объектов.

sources/traits/ObjectArray/ObjectArrayLINQTrait.php

@@ -143,6 +143,22 @@ trait ObjectArrayLINQTrait
      * @return array Ассоциированный массив с результатом выборки.
      */
     public function GetColumn (string $column, ?callable $wherePredicate = null): array
+    {
+        return $this->GetColumnCallback(fn ($item) => property_exists($item, $column) ? $item->$column : null,
+            $wherePredicate);
+    }
+
+    /**
+     * Получает колонку в массиве данных.
+     *
+     * @param callable $columnPredicate Функция <code>fn (mixed $item): mixed</code>, возвращающая значение элемента
+     *     колонки.
+     * @param callable|null $wherePredicate Условие выборки <code>fn (mixed $item): bool</code>, которое проверяет,
+     *      подходит элемент или нет.
+     *
+     * @return array Ассоциированный массив с результатом выборки.
+     */
+    public function GetColumnCallback (callable $columnPredicate, ?callable $wherePredicate = null): array
     {
         // Создаю результат
         $result = [];
@@ -153,16 +169,12 @@ trait ObjectArrayLINQTrait
             if (!is_object($item))
                 continue;
 
-            // - пропускаю не имеющие требуемого свойства
-            if (!property_exists($item, $column))
-                continue;
-
             // - пропускаю не удовлетворяющие условию
             if ($wherePredicate !== null && !$wherePredicate($item))
                 continue;
 
             // - добавляю значение свойства в результат
-            $result[] = $item->$column;
+            $result[] = $columnPredicate($item);
         }
 
         // Возвращаю результат
@@ -172,7 +184,7 @@ trait ObjectArrayLINQTrait
     /**
      * Заменяет данные в строке\ массива.
      *
-     * @param mixed $setItem Заменяемые элемент.
+     * @param array $setItems Заменяемые элементы.
      * @param callable $wherePredicate Условие выборки <code>fn (mixed $item): bool</code>, которое проверяет,
      *      подходит элемент или нет.
      *
@@ -280,4 +292,46 @@ trait ObjectArrayLINQTrait
         // Возвращаем результат
         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;
+    }
 }

tests/classes/ObjectArrayTest.php

@@ -312,4 +312,44 @@ class ObjectArrayTest extends TestCase
         $this->assertEquals('a', $sr->a);
         $this->assertTrue($sr->c);
     }
+
+    public function testFirst ()
+    {
+        $this->PrepareForTest();
+
+        $array = [
+            new A("a", 3, true),
+            new A("c", 2, false),
+            new A("b", 1, true),
+        ];
+
+        $a_Array = new ObjectArray($array);
+
+        $sr = $a_Array->First();
+
+        $this->assertNotNull($sr);
+        $this->assertInstanceOf(A::class, $sr);
+        $this->assertEquals('a', $sr->a);
+        $this->assertTrue($sr->c);
+    }
+
+    public function testLast ()
+    {
+        $this->PrepareForTest();
+
+        $array = [
+            new A("a", 3, true),
+            new A("c", 2, false),
+            new A("b", 1, true),
+        ];
+
+        $a_Array = new ObjectArray($array);
+
+        $sr = $a_Array->Last();
+
+        $this->assertNotNull($sr);
+        $this->assertInstanceOf(A::class, $sr);
+        $this->assertEquals('b', $sr->a);
+        $this->assertTrue($sr->c);
+    }
 }