Перечисление функций

Эти функции создают и управляют значениями списка.

Информация

Имя	Описание
List.Count	Возвращает количество элементов в списке.
List.IsEmpty	Возвращает true, если список пуст.
List.NonNullCount	Возвращает количество элементов, отличных от NULL в списке.

Отбор

Имя	Описание
List.Alternate	Возвращает список, состоящий из всех нечетных элементов смещения в списке.
List.Buffer	Буферизирует список.
List.Distinct	Возвращает список значений с удаленными дубликатами.
List.FindText	Возвращает список значений (включая поля записи), содержащие указанный текст.
List.First	Возвращает первое значение списка или указанное значение по умолчанию, если пусто.
List.FirstN	Возвращает первый набор элементов в списке, указав количество возвращаемых элементов или соответствующее условие.
List.InsertRange	Вставляет значения в список по указанному индексу.
List.IsDistinct	Указывает, есть ли дубликаты в списке.
List.Last	Возвращает последнее значение списка или указанное значение по умолчанию, если пусто.
List.LastN	Возвращает последнее значение в списке. При необходимости можно указать количество возвращаемых значений или условие.
List.MatchesAll	Возвращает true, если функция условия удовлетворена всеми значениями в списке.
List.MatchesAny	Возвращает true, если функция условия удовлетворена любым значением.
List.Positions	Возвращает список смещений для входных данных.
List.Range	Возвращает подмножество списка, начиная с смещения.
List.Select	Возвращает список значений, соответствующих условию.
List.Single	Возвращает единственный элемент списка, если длина списка равна единице; в противном случае вызывает исключение.
List.SingleOrDefault	Возвращает один элемент списка для списка длины один и значение по умолчанию для пустого списка.
List.Skip	Возвращает список, пропускающий указанное число элементов в начале списка.

Функции преобразования

Имя	Описание
List.Accumulate	Аккумулирует суммарное значение из элементов в списке.
List.Combine	Возвращает один список путем объединения нескольких списков.
List.ConformToPageReader	Эта функция предназначена только для внутреннего использования.
List.RemoveFirstN	Возвращает список, пропускающий указанное число элементов в начале списка.
List.RemoveItems	Удаляет элементы из первого списка, присутствующих во втором списке.
List.RemoveLastN	Возвращает список, который удаляет указанное количество элементов из конца списка.
List.RemoveMatchingItems	Удаляет все вхождения указанных значений.
List.RemoveNulls	Удаляет все значения null из указанного списка.
List.RemoveRange	Удаляет количество значений, начиная с указанной позиции.
List.Repeat	Возвращает список, состоящий из count повторений исходного списка.
List.ReplaceMatchingItems	Заменяет вхождения существующих значений в списке на новые значения, которые соответствуют условию.
List.ReplaceRange	Заменяет count число значений, начиная с position, значениями замены.
List.ReplaceValue	Выполняет поиск указанного значения в списке и заменяет его.
List.Reverse	Изменяет порядок значений в списке.
List.Split	Разбивает указанный список на список списков, используя указанный размер страницы.
List.Transform	Возвращает новый список значений, вычисляемых из этого списка.
List.TransformMany	Возвращает список, элементы которого преобразуются из входного списка с помощью указанных функций.
List.Zip	Возвращает список списков путем объединения элементов в одной позиции в нескольких списках.

Функции членства

Так как все значения можно проверить на равенство, эти функции могут работать над разнородными списками.

Имя	Описание
List.AllTrue	Возвращает true, если все выражения верны.
List.AnyTrue	Возвращает значение true, если любое выражение имеет значение true.
List.Contains	Указывает, содержит ли список значение.
List.ContainsAll	Указывает, где список содержит все значения в другом списке.
List.ContainsAny	Указывает, где список содержит любое из значений в другом списке.
List.PositionOf	Возвращает смещение(-я) значения в списке.
List.PositionOfAny	Возвращает первое смещение значения в списке.

Установка операций

Имя	Описание
List.Difference	Возвращает разницу между двумя заданными списками.
List.Intersect	Возвращает пересечение значений списка, найденных во входных данных.
List.Union	Возвращает объединение значений списка, найденных в входных данных.

Заказ

Функции упорядочивания выполняют сравнения. Все значения, которые сравниваются, должны быть сопоставимы друг с другом. Это означает, что все они должны поступать из одного типа данных (или включать значение NULL, которое всегда сравнивает наименьшее значение). В противном случае выбрасывается Expression.Error.

К сопоставимым типам данных относятся:

• Число
• Длительность
• ДатаВремя
• Текст
• Логический
• Недействительный

Имя	Описание
List.Max	Возвращает максимальное значение или значение по умолчанию для пустого списка.
List.MaxN	Возвращает максимальное значение в списке. Необходимо указать количество возвращаемых значений или условие фильтрации.
List.Median	Возвращает медианное значение в списке.
List.Min	Возвращает минимальное значение или значение по умолчанию для пустого списка.
List.MinN	Возвращает минимальное значение в списке. Можно указать количество возвращаемых значений или условие фильтрации.
List.Sort	Сортирует список данных в соответствии с указанными критериями.
List.Percentile	Возвращает один или несколько выборок процентилей, соответствующих заданным вероятностям.

Средние

Эти функции работают с однородными списками чисел, дата-время и продолжительности.

Имя	Описание
List.Average	Возвращает среднее значение значений. Работает со значениями числа, даты, даты и времени, даты и времени с учетом часового пояса и длительности.
List.Mode	Возвращает наиболее частое значение в списке.
List.Modes	Возвращает список наиболее частых значений в списке.
List.StandardDeviation	Возвращает выборку на основе оценки стандартного отклонения. Эта функция выполняет оценку на основе выборки. Результатом будет число для числовых значений и продолжительность для даты и времени, а также для длительностей.

Сложение

Эти функции работают над однородными списками чисел или длительности.

Имя	Описание
List.Sum	Возвращает сумму элементов в списке.

Числовые значения

Эти функции работают только над числами.

Имя	Описание
List.Covariance	Возвращает ковариантность между двумя списками чисел.
List.Product	Возвращает продукт чисел в списке.

Генераторы

Эти функции создают список значений.

Имя	Описание
List.Dates	Создает список значений date с начальным значением, подсчетом и добавочным значением длительности.
List.DateTimes	Создает список значений datetime с начальным значением, подсчетом и добавочным значением длительности.
List.DateTimeZones	Создает список значений datetimezone с начальным значением, подсчетом и добавочным значением длительности.
List.Durations	Создает список значений duration с начальным значением, подсчетом и добавочным значением длительности.
List.Generate	Создает список значений.
List.Numbers	Возвращает список чисел с начальным значением, подсчетом и необязательным добавочным значением.
List.Random	Возвращает список случайных чисел.
List.Times	Создает список значений time с начальным значением, подсчетом и добавочным значением длительности.

Значения параметров

Спецификация события

• Occurrence.First = 0;
• Вхождения.Last = 1;
• Случаи.Все = 2;

Порядок сортировки

• Порядок.Возрастание = 0;
• Order.Descending = 1;

Критерии уравнения

Критерии уравнения для значений списка можно указать следующим образом:

• Значение функции, которое является:
  • Ключевой селектор, определяющий значение в списке для применения критериев равенства.
  • Функция сравнения, используемая для указания типа применяемого сравнения. Можно указать встроенные функции сравнения — перейдите к функциям сравнения.
• Значение списка, содержащее:
  • Ровно два элемента.
  • Первый элемент — это селектор ключей, как указано выше.
  • Второй элемент — это сравнение, как указано выше.

Дополнительные сведения и примеры см. в List.Distinct.

Критерии сравнения

Критерий сравнения можно указать как одно из следующих значений:

• Числовое значение, указывающее порядок сортировки. Для получения дополнительной информации перейдите на порядок сортировки.
• Чтобы вычислить ключ, используемый для сортировки, можно использовать функцию одного аргумента.
• Чтобы выбрать ключ и порядок управления, критерий сравнения может быть списком, содержащим ключ и порядок.
• Для полного управления сравнением можно использовать функцию двух аргументов, возвращающую значение -1, 0 или 1 с учетом связи между левыми и правыми входными данными. Value.Compare — это метод, который можно использовать для делегирования этой логики.

Дополнительные сведения и примеры см. в List.Sort.

Операции замены

Операции замены задаются значением списка. Каждый элемент этого списка должен быть следующим:

• Значение списка ровно из двух элементов.
• Первый элемент — это старое значение в списке, которое необходимо заменить.
• Второй элемент — это новое значение, которое должно заменить все вхождения старого значения в списке.