Перечисление функций
Эти функции создают и управляют значениями списка.
Имя | Описание |
---|---|
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 | Возвращает список значений времени количества размеров, начиная с начала. |
- Occurrence.First = 0;
- Вхождения.Last = 1;
- Случаи.Все = 2;
- Порядок.Возрастание = 0;
- Order.Descending = 1;
Критерии уравнения для значений списка можно указать следующим образом:
- Значение функции, которое является:
- Ключевой селектор, определяющий значение в списке для применения критериев равенства.
- Функция сравнения, используемая для указания типа применяемого сравнения. Можно указать встроенные функции сравнения — перейдите к функциям сравнения.
- Значение списка, содержащее:
- Ровно два элемента.
- Первый элемент — это селектор ключей, как указано выше.
- Второй элемент — это сравнение, как указано выше.
Дополнительные сведения и примеры см. в List.Distinct.
Критерий сравнения можно указать как одно из следующих значений:
- Числовое значение, указывающее порядок сортировки. Для получения дополнительной информации перейдите на порядок сортировки.
- Чтобы вычислить ключ, используемый для сортировки, можно использовать функцию одного аргумента.
- Чтобы выбрать ключ и порядок управления, критерий сравнения может быть списком, содержащим ключ и порядок.
- Для полного управления сравнением можно использовать функцию двух аргументов, возвращающую значение -1, 0 или 1 с учетом связи между левыми и правыми входными данными. Value.Compare — это метод, который можно использовать для делегирования этой логики.
Дополнительные сведения и примеры см. в List.Sort.
Операции замены задаются значением списка. Каждый элемент этого списка должен быть следующим:
- Значение списка ровно из двух элементов.
- Первый элемент — это старое значение в списке, которое необходимо заменить.
- Второй элемент — это новое значение, которое должно заменить все вхождения старого значения в списке.