Бөлісу құралы:

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

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

Информация

Имя Описание
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 с начальным значением, подсчетом и добавочным значением длительности.

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

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

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

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

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

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

В большинстве функций списка функция сравнения, используемая в параметре equationCriteria , должна быть одной из встроенных функций сравнения. В этих функциях списка использование пользовательского средства сравнения приводит к ошибке. Однако следующие функции списка позволяют использовать настраиваемые компараторы:

Для получения дополнительной информации и примеров перейдите по ссылкам List.Distinct и List.PositionOf.

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

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

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

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

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

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

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