Прочитать на английском

Поделиться через


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

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

Информация

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

Отбор

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

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

Имя Описание
List.Accumulate Накапливает результат из списка. Начиная с начального значения, эта функция применяет функцию аккумулятора и возвращает окончательный результат.
List.Combine Объединяет список списков в один список.
List.ConformToPageReader Эта функция предназначена только для внутреннего использования.
List.RemoveRange Возвращает список, удаляющий указанное количество элементов, начиная с указанной позиции. Число по умолчанию — 1.
List.RemoveFirstN Возвращает список с указанным числом элементов, удаленных из списка, начиная с первого элемента. Количество удаленных элементов зависит от необязательного параметра countOrCondition.
List.RemoveItems Удаляет элементы из list1, присутствующих в list2, и возвращает новый список.
List.RemoveLastN Возвращает список с указанным числом элементов, удаленных из списка, начиная с последнего элемента. Количество удаленных элементов зависит от необязательного параметра countOrCondition.
List.Repeat Возвращает список, который повторяет содержимое входного списка указанное количество раз.
List.ReplaceRange Возвращает список, в котором количество значений в списке заменяется списком replaceWith, начиная с определенного индекса.
List.RemoveMatchingItems Удаляет все вхождения заданных значений в списке.
List.RemoveNulls Удаляет значения NULL из списка.
List.ReplaceMatchingItems Заменяет существующие значения в списке на новые, используя предоставленный equationCriteria. Старые и новые значения предоставляются параметрами replacements. Для управления сравнениями равенства можно указать необязательное значение критерия уравнения. Для получения сведений о операциях замены и критериях уравнения см. раздел значения параметров.
List.ReplaceValue Выполняет поиск определённого значения в списке значений и заменяет каждое его вхождение значением замены.
List.Reverse Возвращает список, который переворачивает порядок элементов в списке.
List.Split Разбивает указанный список на список списков, используя указанный размер страницы.
List.Transform Выполняет функцию для каждого элемента в списке и возвращает новый список.
List.TransformMany Возвращает список, элементы которого проецируются из входного списка.

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

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

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

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

Имя Описание
List.Difference Возвращает элементы в списке 1, которые не отображаются в списке 2. Поддерживаются повторяющиеся значения.
List.Intersect Возвращает список из списка списков, находя общие элементы в каждом отдельном списке. Поддерживаются повторяющиеся значения.
List.Union Возвращает список из списка списков и объединяет элементы в каждом из этих списков. Возвращенный список содержит все элементы в любых входных списках. Повторяющиеся значения сопоставляются как часть Союза.
List.Zip Возвращает список списков, объединяющих элементы в одной позиции.

Заказ

Функции упорядочивания выполняют сравнения. Все значения, которые сравниваются, должны быть сопоставимы друг с другом. Это означает, что все они должны поступать из одного типа данных (или включать значение 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.StandardDeviation выполняет оценку на основе выборки. Результатом будет число для числовых значений и продолжительность для даты и времени, а также для длительностей.

Сложение

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

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

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

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

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

Генераторы

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

Имя Описание
List.Dates Возвращает список значений даты из числа размеров, начиная с начала и добавляя добавочное значение к каждому значению.
List.DateTimes Возвращает список значений даты и времени из числа размеров, начиная с начала и добавляя добавочное значение к каждому значению.
List.DateTimeZones Возвращает список значений даты и времени из числа размеров, начиная с начала и добавляя добавочное значение к каждому значению.
List.Durations Возвращает список значений длительности из числа размеров, начиная с начала и добавляя к каждому значению добавочное значение.
List.Generate Создает список значений.
List.Numbers Возвращает список чисел размером count, начиная с initial, и прибавляет increment. Приращение по умолчанию — 1.
List.Random Возвращает список случайных чисел с необязательным параметром начального значения.
List.Times Возвращает список значений времени количества размеров, начиная с начала.

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

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

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

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

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

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

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

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

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

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

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

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

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

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