Обходимое
Стд::Обходимое<ТипЭлемента>
ТипЭлемента: тип обходимых элементов.
Объект предоставляет возможно сть обхода своих элементов в цикле для из.
Возможность повторного обхода не гарантируется.
Сравнение ссылочное
Иерархия типа
Базовые типы: Объект
Дочерние типы: ЧитаемаяКоллекция, ЧитаемоеСоответствие
Методы
ВМассив
ВМассив(): Массив<ТипЭлемента>ВСоответствие
ВСоответствие<ТипКлюча, ТипЗначения>(
ИзвлекательКлюча: (ТипЭлемента)->ТипКлюча,
ИзвлекательЗначения: (ТипЭлемента)->ТипЗначения
): Соответствие<ТипКлюча, ТипЗначения>ТипЗначения: тип вычисляемого значения.
Преобразует Обходимое в Соответствие, используя заданные функции для вычисления ключа и значения.
Примеры
знч Сотрудники: Массив<Сотрудник> = ...
// [{Ид: 13, Имя: Петя}, {Ид: 5, Имя: Вася}]
знч ИдИмя = Сотрудники.ВСоответствие(Элемент -> Элемент.Ид, Элемент -> Элемент.Имя) // Соответствие<Число, Строка>
// { 13 : "Петя",
// 5 : "Вася"}
ВСоответствиеСКлючами
ВСоответствиеСКлючами<ТипКлюча>(ИзвлекательКлюча: (ТипЭлемента)->ТипКлюча): Соответствие<ТипКлюча, ТипЭлемента>Преобразует Обходимое в Соответствие, используя заданную функцию для вычисления ключа и элемент обходимого в качестве значения.
Примеры
знч Сотрудники: Массив<Сотрудник> = ...
// [{Ид: 13, Имя: Петя, Возраст: 24},
// {Ид: 5, Имя: Вася, Возраст: 30}]
знч СотрудникПоИд = Сотрудники.ВСоответствиеСКлючами(Элемент -> Элемент.Ид) // Соответствие<Число, Сотрудник>
// {13 : {Ид: 13, Имя: Петя, Возраст: 24},
// 5 : {Ид: 5, Имя: Вася, Возраст: 30}}
ВСоответствиеСоЗначениями
ВСоответствиеСоЗначениями<ТипЗначения>(ИзвлекательЗначения: (ТипЭлемента)->ТипЗначения): Соответствие<ТипЭлемента, ТипЗначения>Преобразует Обходимое в Соответствие, используя заданную функцию для вычисления значения и элемент обходимого в качестве ключа.
Примеры
знч Идентификаторы: Массив<Число> = [13, 5]
знч СотрудникПоИд = Идентификаторы.ВСоответствиеСоЗначениями(Ид -> ПолучитьСотрудникаПоИд(Ид)) // Соответствие<Число, Сотрудник>
// {13 : {Ид: 13, Имя: Петя, Возраст: 24},
// 5 : {Ид: 5, Имя: Вася, Возраст: 30}}
ВоМножество
ВоМножество(): Множество<ТипЭлемента>Примеры
знч Числа = [1, 3, 5, 10, 12, 1, 3, 5]
знч МножествоЧисел = Числа.ВоМножество() // {1, 3, 5, 10, 12}
ВсеСоответствуют
Возвращает Истина, если все элементы удовлетворяют условию в предикате. На сервере это операция сокращенного вычисления. Это значит, что вызванные ранее в цепочке вызовов операции, могут быть вызваны не для каждого элемента.Примеры
знч Сотрудники: Массив<Сотрудник> = ...
// [{Ид: 13, Имя: Петя, Отдел: Администрация},
// {Ид: 5, Имя: Вася, Отдел: Администрация},
// {Ид: 6, Имя: Иван, Отдел: Разработка}]
Сотрудники.ВсеСоответствуют(Элемент -> Элемент.Отдел == "Разработка") // Ложь
// пример сокращенного вычисления
знч Числа = [1, 2, 3, 4, 5]
знч КвадратыЧисел = <Число>[]
знч ВсеЧетные = Числа.ДляКаждого(а -> КвадратыЧисел.Добавить(а * а)).ВсеСоответствуют(а -> а % 2 == 0) // Ложь
// КвадратыЧисел = [1]
ГруппироватьПо
ГруппироватьПо<ТипКлюча>(Извлекатель: (ТипЭлемента)->ТипКлюча): Соответствие<ТипКлюча, Массив<ТипЭлемента>>Группирует элементы в соответствии с заданной функцией вычисления ключа. Элементы с одинаковым ключом объединяются в Массив.
Извлекатель - функция, применяющаяся к каждому элементу, возвращающая характеристику, по которой будут группироваться элементы.
Примеры
знч Сотрудники: Массив<Сотрудник> = ...
// [{Ид: 13, Имя: Петя, Отдел: Администрация},
// {Ид: 5, Имя: Вася, Отдел: Администрация},
// {Ид: 6, Имя: Иван, Отдел: Разработка}]
знч ОтделыИСотрудники: Соответствие<Строка, Массив<Сотрудник>> = Сотрудники.ГруппироватьПо(Элемент -> Элемент.Отдел)
// {
// Администрация: [{Ид: 13, Имя: Петя, Отдел: Администрация},
// {Ид: 5, Имя: Вася, Отдел: Администрация}],
// Разработка: [{Ид: 6, Имя: Иван, Отдел: Разработка}]
// }
ДляКаждого
ДляКаждого(Действие: (ТипЭлемента)->ничто): Массив<ТипЭлемента>Примеры
знч Сотрудники: Массив<Сотрудник> = ...
// [{Ид: 13, Имя: Петя}, {Ид: 5, Имя: Вася}]
Сотрудники.ДляКаждого(Элемент -> Консоль.Записать(Элемент. Ид + " - " + Элемент.Имя))
// 13 - Петя
// 5 - Вася
// В примере ниже действие 'а -> КвадратыЧисел.Добавить(а * а)'
// на сервере будет вызвано только для первого элемента
знч Числа = [1, 3, 5]
знч КвадратыЧисел = <Число>[]
знч Первое = Числа.ДляКаждого(а -> КвадратыЧисел.Добавить(а * а)).ПервыйИлиУмолчание() // 1
// КвадратыЧисел = [1]
Единственный
Единственный(): ТипЭлементаИсключения
ИсключениеНедопустимоеСостояние - если нет элементов или элементов больше одного.
ЕдинственныйИлиНеопределено
Един ственныйИлиНеопределено(): ТипЭлемента?Неопределено.
Вызов приводит к частичному обходу, если реализация не поддерживает повторный обход - вызвать можно только один раз.
Исключения
ИсключениеНедопустимоеСостояние - если элементов больше одного.
Прошлые имена: ЕдинственныйИлиУмолчание
ЕдинственныйИлиУмолчание
ЕдинственныйИлиУмолчание(Умолчание: ТипЭлемента): ТипЭлементаЕдинственный ИлиУмолчание<ТипУмолчания>(ВычислительУмолчания: ()->ТипЭлемента|ТипУмолчания): ТипЭлемента|ТипУмолчания
Возвращает единственный содержащийся элемент или значение Умолчание, если элементов нет.
Вызов приводит к частичному обходу, если реализация не поддерживает повторный обход - вызвать можно только один раз.
Исключения
ИсключениеНедопустимоеСостояние - если элементов больше одного.
ЕдинственныйИлиУмолчание
ЕдинственныйИлиУмолчание<ТипУмолчания>(ВычислительУмолчания: ()->ТипЭлемента|ТипУмолчания): ТипЭлемента|ТипУмолчанияПерегрузка:
ЕдинственныйИлиУмолчание(Умолчание: ТипЭлемента): ТипЭлемента
Возвращает единственный содержащийся элемент или значение, вычисленное с помощью ВычислительУмолчания, если элементов нет.
Вызов приводит к частичному обходу, если реализация не поддерживает повторный обход - вызвать можно только один раз.
Исключения
ИсключениеНедопустимоеСостояние - если элементов больше одного.
ЕстьСоответствия
Возвращает Истина, если хотя бы один из элементов удовлетворяет условию в предикате. На сервере это операция сокращенного вычисления. Это значит, что вызванные ранее в цепочке вызовов операции, могут быть вызваны не для каждого элемента.Примеры
знч Сотрудники: Массив<Сотрудник> = ...
// [{Ид: 13, Имя: Петя, Отдел: Администрация},
// {Ид: 5, Имя: Вася, Отдел: Администрация},
// {Ид: 6, Имя: Иван, Отдел: Разработка}]
Сотрудники.ЕстьСоответствия(Элемент -> Элемент.Отдел == Администрация) // Истина
// пример сокращенного вычисления
знч Числа = [1, 2, 3, 4, 5]
знч КвадратыЧисел = <Число>[]
знч ЕстьЧетные = Числа.ДляКаждого(а -> КвадратыЧисел.Добавить(а * а)).ЕстьСоответствия(а -> а % 2 == 0) // Истина
// КвадратыЧисел = [1, 4]
КакПоследовательность
КакПоследовательность(): Последовательность<ТипЭлемента>Максимум
<ItemType это Сравнимое<ТипЭлемента>> Максимум(): ТипЭлементаИсключения
ИсключениеНедопустимоеСостояние - если нет элементов.
Примеры
знч Числа = [1, 3, 5, 10, 12]
знч Макс = Числа.Максимум() // 12
МаксимумПо
МаксимумПо(Извлекатель: (ТипЭлемента)->Сравнимое<неизвестно>): ТипЭлементаПримеры
знч Сотрудники: Массив<Сотрудник> = ...
// [{Имя: Петя, Возраст: 25},
// {Имя: Вася, Возраст: 24},
// {Имя: Иван, Возраст: 30}]
знч СтаршийСотрудник: Сотрудник = Сотрудники.МаксимумПо(Элемент -> Элемент.Возраст)
// {Имя: Иван, Возраст: 30}
Минимум
<ItemType это Сравнимое<ТипЭлемента>> Минимум(): ТипЭлементаИсключения
ИсключениеНедопустимоеСостояние - если нет элементов.
Примеры
знч Числа = [1, 3, 5, 10, 12]
знч Минимум: Число = Числа.Минимум() // 1
МинимумПо
МинимумПо(Извлекатель: (ТипЭлемента)->Сравнимое<неизвестно>): ТипЭлементаИсключения
ИсключениеНедопустимоеСостояние - если нет элементов.
Примеры
знч Сотрудники: Массив<Сотрудник> = ...
// [{Имя: Петя, Возраст: 25},
// {Имя: Вася, Возраст: 24},
// {Имя: Иван, Возраст: 30}]
знч МладшийСотрудник: Сотрудник = Сотрудники.МинимумПо(Элемент -> Элемент.Возраст)
// {Имя: Вася, Возраст: 24}
НетСоответствий
Возвращает Истина, если ни один из элементов не удовлетворяет условию в предикате. На сервере это операция сокращенного вычисления. Это значит, что вызванные ранее в цепочке вызовов операции, могут быть вызваны не для каждого элемента.Примеры
знч Сотрудники: Массив<Сотрудник> = ...
// [{Ид: 13, Имя: Петя, Отдел: Администрация},
// {Ид: 5, Имя: Вася, Отдел: Администрация},
// {Ид: 6, Имя: Иван, Отдел: Разработка}]
Сотрудники.НетСоответствий(Элемент -> Элемент.Отдел == Бухгалтерия) // Истина
// пример сокращенного вычисления
знч Числа = [1, 2, 3, 4, 5]
знч КвадратыЧисел = <Число>[]
знч НетЧетных = Числа.ДляКаждого(а -> КвадратыЧисел.Добавить(а * а)).НетСоответствий(а -> а % 2 == 0) // Ложь
// КвадратыЧисел = [1, 4]
Объединить
@ПроверятьИспользованиеЗначения
Объединить(Обходимое: Обходимое<ТипЭлемента>): Массив<ТипЭлемента>Обходимое и возвращает новый массив.
Примеры
знч Сотрудники: Массив<Сотрудник> = ...
// [{Имя: Петя, Возраст: 25},
// {Имя: Вася, Возраст: 24}]
знч Сотрудники2: Массив<Сотрудник> = ...
// [{Имя: Иван, Возраст: 26},
// {Имя: Андрей, Возраст: 27}]
знч ВсеСотрудники: Массив<Сотрудник> = Сотрудники.Об ъединить(Сотрудники2)
// [{Имя: Петя, Возраст: 25},
// {Имя: Вася, Возраст: 24},
// {Имя: Иван, Возраст: 26},
// {Имя: Андрей, Возраст: 27}]
Первый
Первый(): ТипЭлементаИсключения
ИсключениеНедопустимоеСостояние - если элементов нет.
ПервыйИлиНеопределено
ПервыйИлиНеопределено(): ТипЭлемента?Неопределено
Вызов приводит к частичному обходу, если реализация не поддерживает повторный обход - вызвать можно только один раз.
На сервере это операция сокращенного вычисления.
Это значит, что вызванные ранее в цепочке вызовов операции, могут быть вызваны не для каждого элемента.
Примеры
знч Числа = [1, 3, 5, 10, 12, 15, 20]
знч Первый = Числа.Первый ИлиУмолчание() // 1
// пример сокращенного вычисления
знч КвадратыЧисел = <Число>[]
знч Первый1 = Числа.ДляКаждого(а -> КвадратыЧисел.Добавить(а * а)).ПервыйИлиУмолчание() // 1
// КвадратыЧисел = [1]
Прошлые имена: ПервыйИлиУмолчание
ПервыйИлиУмолчание
ПервыйИлиУмолчание(Умолчание: ТипЭлемента): ТипЭлементаПервыйИлиУмолчание<ТипУмолчания>(ВычислительУмолчания: ()->ТипЭлемента|ТипУмолчани я): ТипЭлемента|ТипУмолчания
Возвращает первый элемент или значение Умолчание, если элементов нет.
Вызов приводит к частичному обходу, если реализация не поддерживает повторный обход - вызвать можно только один раз.
На сервере это операция сокращенного вычисления.
Это значит, что вызванные ранее в цепочке вызовов операции, могут быть вызваны не для каждого элемента.
Примеры
знч Числа = [1, 3, 5, 10, 12, 15, 20]
знч Первый = Числа.ПервыйИлиУмолчание(0) // 1
// пример сокращенного вычисления
знч КвадратыЧисел = <Число>[]
знч Первый1 = Числа.ДляКаждого(а -> КвадратыЧисел.Добавить(а * а)).ПервыйИлиУмолчание(0) // 1
// КвадратыЧисел = [1]
ПервыйИлиУмолчание
ПервыйИлиУмолчание<ТипУмолчания>(ВычислительУмолчания: ()->ТипЭлемента|ТипУмолчания): ТипЭлемента|ТипУмолчанияПерегрузка:
ПервыйИлиУмолчание(Умолчание: ТипЭлемента): ТипЭлемента
Возвращает первый элемент или значение, вычисленное с помощью ВычислительУмолчания, если элементов нет.
Вызов приводит к частичному обходу, если реализация не поддерживает повторный обход - вызвать можно только один раз.
На сервере это операция сокращенного вычисления.
Это значит, что вызванные ранее в цепочке вызовов операции, могут быть вызваны не для каждого элемента.
Примеры
знч Числа = [1, 3, 5, 10, 12, 15, 20]
знч Первый = Числа.ПервыйИлиУмолчание(() -> 0) // 1
// пример сокращенного вычисления
знч КвадратыЧисел = <Число>[]
знч Первый1 = Числа.ДляКаждого(а -> КвадратыЧисел.Добавить(а * а)).ПервыйИлиУмолчание(() -> 0) // 1
// КвадратыЧисел = [1]
ПотомСортироватьПо
@ПроверятьИспользованиеЗначения
ПотомСортироватьПо(
Извлекатель: (ТипЭлемента)->Сравнимое<неизвестно>,
Направление: НаправлениеСортировки = НаправлениеСортировки.ПоВозрастанию
): Массив<ТипЭлемента>Извлекатель для сравнения элементов. Возвращает новый отсортированный Массив.
Извлекатель - функция, применяющаяся к каждому элементу, возвращающая характеристику, которая непосредственно будет сравниваться с характеристиками остальных значений для упорядочивания.
Например для структуры извлекатель может возвращать свойство, по которому сравниваются структуры.
Примеры
знч Сотрудники: Массив<Сотрудник> = ...
// [{Ид: 13, Возраст: 31, Имя: Петя},
// {Ид: 18, Возраст: 42, Имя: Иван},
// {Ид: 5, Возраст: 42, Имя: Вася}]
знч ПоВозрастаниюИд = Сотрудники.СортироватьПо(Элемент -> Элемент.Возраст).ПотомСортироватьПо(Элемент -> Элемент.Ид)
// [{Ид: 13, Возраст: 31, Имя: Петя},
// {Ид: 5, Возраст: 42, Имя: Вася},
// {Ид: 18, Возраст: 42, Имя: Иван}]
Преобразовать
Применяет функцию к каждому элементу обходимого и возвращает массив с результатами.
ПропуститьНеопределено - если Истина и результатом функции является Неопределено, элемент не будет включен в результирующий массив. Иначе будет.
Примеры
знч Сотрудники: Массив<Сотрудник> = ...
//[{Ид: 1, Имя: Петя}, {Ид: 2, Имя: Вася}]
знч Имена: Массив<Строка> = Сотрудники.Преобразовать(Сотрудник -> Сотрудник.Имя)
//[Петя, Вася]
ПреобразоватьЛинейно
Преобразует каждый элемент Обходимого в Массив и объединяет в общий Массив.
Примеры
знч Отделы: Массив<Отдел> = ...
//[{Ид: 1, Сотрудники: [Петя, Вася]},
// {Ид: 2, Сотрудники: [Иван, Андрей]}]
знч ВсеСотрудники: Массив<Строка> = Отделы.ПреобразоватьЛинейно(Отдел -> Отдел.Сотрудники())
// [Петя, Вася, Иван, Андрей]
Пусто
Пусто(): БулевоСвернуть
Свернуть(Операция: (ТипЭлемента, ТипЭлемента)->ТипЭлемента): ТипЭлементаСвернуть(НачальноеЗначение: ТипЭлемента, Операция: (ТипЭлемента, ТипЭлемента)->ТипЭлемента): ТипЭлемента
Сводит все элементы Обходимого к одному значению с помощью заданной операции.
Операция - функция, которая принимает два аргумента, выполняет над ними некоторую операцию и возвращает результат.
Затем эта функция опять применяется к результату и следующему элементу.
Исключения
ИсключениеНедопустимоеСостояние - если нет элементов.
Примеры
знч Числа = [1, 3, 5, 10]
знч Сумма = Числа.Свернуть((а, б) -> а + б) // 19
Свернуть
Свернуть(
НачальноеЗначение: ТипЭлемента,
Операция: (ТипЭлемента, ТипЭлемента)->ТипЭлемента
): ТипЭлементаСвернуть(Операция: (ТипЭлемента, ТипЭлемента)->ТипЭлемента): ТипЭлемента
Сводит все элементы Обходимого к одному значению с помощью заданной операции и начального значения.
Операция - функция, которая принимает два аргумента, выполняет над ними некоторую операцию и возвращает результат.
Затем эта функция опять применяется к результату и следующему элементу.
Примеры
знч Числа = [1, 3, 5, 10]
знч Сумма = Числа.Свернуть(100, (а, б) -> а + б) // 119
Соединить
Соединяет элементы в одну строку, с разделителемРазделитель.
Исключения
ИсключениеНедопустимоеСостояние - если нет элементов.
Примеры
знч Сотрудники = ["Петя", "Вася", "Иван"]
знч Список = Сотрудники.Соединить(", ") // "Петя, Вася, Иван"
Сортировать
@ПроверятьИспользованиеЗначения
Сортировать(Компаратор: (ТипЭлемента, ТипЭлемента)->Число): Массив<ТипЭлемента><ItemType это Сравнимое<ТипЭлемента>> Сортировать(Направление: НаправлениеСортировки = НаправлениеСортировки.ПоВозрастанию): Массив<ТипЭлемента>
Сортирует Обходимое, используя Компаратор для сравнения элементов.
Возвращает новый отсортированный Массив.
Примеры
знч Числа = [10, 12, 1, 3, 5]
знч ПоВозрастанию = Числа.Сортировать((а, б) -> а - б) // [1, 3, 5, 10, 12]
знч ПоУбыванию = Числа.Сортировать((а, б) -> б - а) // [12, 10, 5, 3, 1]
Сортировать
@ПроверятьИспользованиеЗначения
<ItemType это Сравнимое<ТипЭлемента>> Сортировать(Направление: НаправлениеСортировки = НаправлениеСортировки.ПоВозрастанию): Массив<ТипЭлемента>Сортировать(Компаратор: (ТипЭлемента, ТипЭлемента)->Число): Массив<ТипЭлемента>
Сортирует элементы обходимого типа Сравнимое. Возвращает новый отсортированный Массив.
Примеры
знч Числа = [10, 12, 1, 3, 5]
знч ПоВозрастанию = Числа.Сортировать() // [1, 3, 5, 10, 12]
знч ПоУбыванию = Числа.Сортировать(НаправлениеСортировки.ПоУбыванию) // [12, 10, 5, 3, 1]
СортироватьПо
@ПроверятьИспользованиеЗначения
СортироватьПо(
Извлекатель: (ТипЭлемента)->Сравнимое<неизвестно>,
Направление: НаправлениеСортировки = НаправлениеСортировки.ПоВозрастанию
): Массив<ТипЭлемента>Извлекатель для сравнения элементов. Возвращает новый отсортированный Массив.
Извлекатель - функция, применяющаяся к каждому элементу, возвращающая характеристику, которая непосредственно будет сравниваться с характеристиками остальных значений для упорядочивания.
Например для структуры извлекатель может возвращать свойство, по которому сравниваются структуры.
Примеры
знч Сотрудники: Массив<Сотрудник> = ...
// [{Ид: 13, Имя: Петя}, {Ид: 5, Имя: Вася}]
знч ПоВозрастаниюИд = Сотрудники.СортироватьПо(Элемент -> Элемент.Ид)
// [{Ид: 5, Имя: Вася}, {Ид: 13, Имя: Петя}]
Среднее
Возвращает среднее арифметическое элементов типа Число.Исключения
ИсключениеНедопустимоеСостояние - если нет элементов.
Примеры
знч Среднее: = [1, 2, 3, 4, 5].Среднее() // 3
СреднееИлиУмолчание
Возвращает среднее арифметическое элементов типа Число илиУмолчание, если элементов нет.
Примеры
знч Среднее: = [1, 2, 3, 4, 5].СреднееИлиУмолчание() // 3
знч Среднее: = <Число>[].СреднееИлиУмолчание(5) // 5
Сумма
Возвращает сумму элементов типа Число или 0, если элементов нет.Примеры
знч Сумма: = [1, 2, 3, 4, 5].Сумма() // 15
Уникальные
Уникальные(): Массив<ТипЭлемента>Примеры
знч Числа = [12, 10, 5, 3, 1, 3, 5, 10]
знч УникальныеЧисла = Числа.Уникальные() // [12, 10, 5, 3, 1]
УникальныеПо
УникальныеПо<ТипСвойства>(Извлекатель: (ТипЭлемента)->ТипСвойства): Массив<ТипЭлемента>Возвращает новый Массив, в котором содержатся только уникальные по определенному свойству элементы Обходимого. В случае с одинаковыми свойствами, в результирующий массив попадет первое вхождение.
Извлекатель - функция, применяющаяся к каждому элементу, возвращающая характеристику, по которой будет определяться уникальность элементов.
Примеры
знч Сотрудники: Массив<Сотрудник> = ...
// [{Имя: Петя, Возраст: 25},
// {Имя: Вася, Возраст: 24},
// {Имя: Иван, Возраст: 25}]
знч УникальныеПоВозрасту: Массив<Сотрудник> = Сотрудники.УникальныеПо(Элемент -> Элемент.Возраст)
// [{Имя: Петя, Возраст: 25},
// {Имя: Вася, Возраст: 24}]
Фильтровать
@ПроверятьИспользованиеЗначения
Фильтровать(Фильтр: (ТипЭлемента)->Булево): Массив<ТипЭлемента>Примеры
знч Числа = [1, 3, 5, 10, 12]
знч Четные = Числа.Фильтровать(Элемент -> Элемент % 2 == 0) // [10, 12]
ФильтроватьПоТипу
ФильтроватьПоТипу<ЦелевойТип>(): Массив<ЦелевойТип>Фильтрует обходимое, оставляя только значения типа TargetType и возвращает массив из этих элементов.
Примеры
знч Объекты = [1, 2, "3", "4", True, False]
знч Числа = Объекты.ФильтроватьПоТипу<Число>() // [1, 2]