A1sAR — массивы без ручных циклов

// Намерение: Создаёт массив из переданных значений (до 40 элементов).
// Граница: Обязательных параметров нет; все параметры необязательны (41).
// Результат: Array.

// Базовое использование
Числа = A1sAR.Of(1, 2, 3);  // [1, 2, 3]

// С Неопределено — РАБОТАЕТ!
Смешанный = A1sAR.Of(1, Неопределено, 3);  // [1, Неопределено, 3]

// Намерение: Создает новый массив заданного размера, заполненный одинаковым значением.
// Граница: Обязательные параметры: ArraySize, DefaultValueForAllElements
// Результат: Array.

// A1sAR.OfN(5, "test") -> ["test", "test", "test", "test", "test"]
// A1sAR.OfN(3, 0) -> [0, 0, 0]
// A1sAR.OfN(2, Новый Структура()) -> [Структура{}, Структура{}]

// Намерение: Создаёт фиксированный (неизменяемый) массив из переданных значений (до 40 элементов).
// Граница: Обязательных параметров нет; все параметры необязательны (40).
// Результат: FixedArray.

Const = A1sAR.OfFixed("A", "B", "C"); // [A, B, C]
  // Const[0] = "X"; // Ошибка! Массив фиксирован

// Намерение: Разбивает массив на части (чанки) указанного размера.
// Граница: Обязательные параметры: Array, Size
// Результат: Array.

Группы = A1sAR.Chunk(A1sAR.Of(1, 2, 3, 4, 5), 2); // [[1, 2], [3, 4], [5]]

// Намерение: Выравнивает массив на один уровень вложенности (без рекурсии).
// Граница: Обязательные параметры: Array
// Результат: Array.

Плоский = A1sAR.Flatten(A1sAR.Of(A1sAR.Of(1, 2), A1sAR.Of(3, 4), A1sAR.Of(5))); // [1, 2, 3, 4, 5]
  Смеш = A1sAR.Flatten(A1sAR.Of(1, A1sAR.Of(2, A1sAR.Of(3, 4)), 5)); // [1, 2, [3, 4], 5] (только 1 уровень)

// Намерение: Вставляет элемент в массив по указанному индексу (неизменяемый метод).
// Граница: Обязательные параметры: Массив, Индекс, Значение
// Результат: Array.

НовыйМассив = A1sAR.Insert(A1sAR.Of(1, 3), 1, 2); // [1, 2, 3]
  ВКонце = A1sAR.Insert(A1sAR.Of(1), 5, 2); // [1, 2] (индекс за пределами)
  ВНачало = A1sAR.Insert(A1sAR.Of(2, 3), -1, 1); // [1, 2, 3]

// Намерение: Удаляет элемент из массива по указанному индексу (неизменяемый метод).
// Граница: Обязательные параметры: Массив, Индекс
// Результат: Array.

БезВторого = A1sAR.RemoveAt(A1sAR.Of(1, 2, 3), 1); // [1, 3]
  Оригинал = A1sAR.RemoveAt(A1sAR.Of(1, 2, 3), 10); // [1, 2, 3] (индекс за пределами)

// Намерение: Создаёт копию массива с элементами, отсортированными по возрастанию.
// Граница: Обязательные параметры: Массив
// Результат: Array.

Отсортированный = A1sAR.Sort(A1sAR.Of(3, 1, 2)); // [1, 2, 3]

// Намерение: Создаёт копию массива с элементами в обратном порядке.
// Граница: Обязательные параметры: Массив
// Результат: Array.

Разворот = A1sAR.Reverse(A1sAR.Of(1, 2, 3)); // [3, 2, 1]

// Намерение: Глубоко сбрасывает значения элементов массива, заменяя их значениями по умолчанию в соответствии с типами. Поддерживает вложенные массивы, структуры и соответствия.
// Граница: Обязательные параметры: SourceArray
// Результат: Array.

Массив = A1sAR.ResetDeep(Значения);

// Намерение: Сбрасывает значения всех элементов массива к значениям по умолчанию для их типов.
// Граница: Обязательные параметры: SourceArray
// Результат: Boolean.

// Пример 1: Простые типы
Arr = A1sAR.Of(100, "Текст", Истина);
A1sAR.Reset(Arr);
// Arr = [0, "", Ложь]

// Пример 2: Составные типы (Ваша фишка!)
RowData = Новый Структура("Код, Наименование", 1, "Яблоко");
Arr2 = A1sAR.Of(RowData, Новый Массив);

A1sAR.Reset(Arr2);
// Arr2 = [НоваяСтруктура{}, НовыйМассив{}]
// Структура и Массив пересозданы "с нуля", старые данные удалены.

// Намерение: Объединяет до 8 массивов в один результирующий массив.
// Граница: Обязательные параметры: Массив1
// Результат: Array.

Объединение = A1sAR.Concatenate(A1sAR.Of(1, 2), A1sAR.Of(3, 4)); // [1, 2, 3, 4]
  Уникальное = A1sAR.Concatenate(A1sAR.Of(1, 1), A1sAR.Of(2), Истина); // [1, 2]

// Намерение: Удаляет дубликаты из массива, возвращая новый массив с уникальными элементами.
// Граница: Обязательные параметры: Массив
// Результат: Array.

Уникальные = A1sAR.RemoveDuplicates(A1sAR.Of(1, 2, 2, 3, 1)); // [1, 2, 3]

// Намерение: Объединяет до 8 массивов, возвращая только уникальные элементы (множество).
// Граница: Обязательные параметры: Массив1
// Результат: Array.

Уникальные = A1sAR.Union(A1sAR.Of(1, 2), A1sAR.Of(2, 3)); // [1, 2, 3]

// Намерение: Возвращает элементы, присутствующие во всех переданных массивах (пересечение до 8 массивов).
// Граница: Обязательные параметры: Массив1
// Результат: Array.

Пересечение = A1sAR.Intersection(A1sAR.Of(1, 2, 3), A1sAR.Of(2, 3, 4)); // [2, 3]

// Намерение: Возвращает элементы из первого массива, которых нет в остальных массивах (разность до 8 массивов).
// Граница: Обязательные параметры: Массив1
// Результат: Array.

Разность = A1sAR.Difference(A1sAR.Of(1, 2, 3, 4), A1sAR.Of(2, 4)); // [1, 3]

// Намерение: Выбирает элементы массива, соответствующие указанному типу или типам.
// Граница: Обязательные параметры: Array, TypeOrTypes
// Результат: Array.

// Один тип
  Числа = A1sAR.PickByType(Смешанный, Тип("Число"));
  // Массив типов
  ЧислаИСтроки = A1sAR.PickByType(Смешанный, A1sAR.Of(Тип("Число"), Тип("Строка")));
  // ОписаниеТипов
  Описание = Новый ОписаниеТипов("Число, Строка");
  Результат = A1sAR.PickByType(Смешанный, Описание);

// Намерение: Исключает элементы массива, соответствующие указанному типу или типам.
// Граница: Обязательные параметры: Array, TypeOrTypes
// Результат: Array.

// Один тип
  БезЧисел = A1sAR.OmitByType(Смешанный, Тип("Число"));
  // Массив типов
  БезЧиселИСтрок = A1sAR.OmitByType(Смешанный, A1sAR.Of(Тип("Число"), Тип("Строка")));
  // ОписаниеТипов
  Описание = Новый ОписаниеТипов("Число, Строка");
  Результат = A1sAR.OmitByType(Смешанный, Описание);

// Намерение: Выбирает все элементы массива, кроме Неопределено.
// Граница: Обязательные параметры: Array
// Результат: Array.

БезПустот = A1sAR.PickNotNull(A1sAR.Of(1, Неопределено, 3, Неопределено, 5));
  // Результат: [1, 3, 5]

// Намерение: Собирает все типы значений массива в массив уникальных типов.
// Граница: Обязательные параметры: Array
// Результат: Array.

Массив = A1sAR.GetTypes(Значения);

// Намерение: Проверяет, являются ли все элементы массива значениями одного типа.
// Граница: Обязательные параметры: Array
// Результат: Boolean.

Успешно = A1sAR.IsHomoTyped(Значения);

// Намерение: Преобразует гетерогенный массив в массив, гомогенный по типу. Каждый элемент приводится к указанному типу. Если преобразование невозможно — используется DefaultValue.
// Граница: Обязательные параметры: SourceArray, TargetType
// Результат: Array.

Массив = A1sAR.ConvertTo(Значения, TargetType);

// Намерение: Возвращает первый элемент массива или Неопределено, если массив пуст.
// Граница: Обязательные параметры: Массив
// Результат: Arbitrary.

Первый = A1sAR.First(A1sAR.Of(1, 2, 3)); // 1
  Пусто = A1sAR.First(Новый Массив);       // Неопределено

// Намерение: Возвращает последний элемент массива или Неопределено, если массив пуст.
// Граница: Обязательные параметры: Массив
// Результат: Arbitrary.

Последний = A1sAR.Last(A1sAR.Of(1, 2, 3)); // 3
  Пусто = A1sAR.Last(Новый Массив);          // Неопределено

// Намерение: Проверяет, содержит ли массив указанное значение.
// Граница: Обязательные параметры: Массив, Значение
// Результат: Boolean.

Есть = A1sAR.Contains(A1sAR.Of(1, 2, 3), 2); // Истина
  Нет  = A1sAR.Contains(A1sAR.Of(1, 2, 3), 4); // Ложь

// Намерение: Возвращает индекс первого вхождения элемента в массив, или -1, если не найден.
// Граница: Обязательные параметры: Массив, Значение
// Результат: Number.

Индекс = A1sAR.IndexOf(A1sAR.Of("a", "b", "c"), "b"); // 1
  НеНайден = A1sAR.IndexOf(A1sAR.Of(1, 2, 3), 5);       // -1

// Намерение: Объединяет элементы массива в строку с указанным разделителем.
// Граница: Обязательные параметры: Массив, Разделитель
// Результат: String.

Строка = A1sAR.Join(A1sAR.Of(1, 2, 3), ", "); // "1, 2, 3"
  Пусто  = A1sAR.Join(Новый Массив, ",");       // ""

// Намерение: Сравнивает два массива примитивных значений на точное равенство. Сравнение выполняется поэлементно оператором <>.
// Граница: Обязательные параметры: Array1, Array2
// Результат: Boolean.

Успешно = A1sAR.Equals(Значения, Значения);

// Намерение: Глубокое сравнение двух массивов по значению. Поддерживает вложенные массивы, структуры и соответствия.
// Граница: Обязательные параметры: Array1, Array2
// Результат: Boolean.

Успешно = A1sAR.EqualsDeep(Значения, Значения);

// Намерение: Создаёт fluent-обёртку над массивом для цепочечных вызовов.
// Граница: Обязательных параметров нет; все параметры необязательны (1).
// Результат: DataProcessorObject.A1sDP_AR.

// Цепочечный вызов:
Результат = A1sAR.On()
    .Add(1).Add(2).Add(3)
    .RemoveDuplicates()
    .Sort()
    .Value();

// С начальным массивом:
Результат = A1sAR.On(СуществующийМассив)
    .Concatenate(ДругойМассив)
    .Reverse()
    .Value();

// Намерение: Самотест модуля A1sAR с примерами использования.
// Граница: Параметров нет.
// Результат: Boolean.

Успешно = A1sAR.SelfTest();