Функция Sequence
Применимо к:
приложениям на основе холста классическим потокам приложениям на основе модели интерфейсу командной строки Power Platform
Формирует таблицу последовательных номеров.
Description
Функция Sequence генерирует таблицу из одного столбца последовательных чисел, таких как 1, 2, 3. Столбец имеет имя Value. Sequence( 4 ) эквивалентна [1,2,3,4].
Используйте функцию Sequence с функцией ForAll для итерации определенное количество раз. Например, следующая формула добавляет 10 случайных чисел в коллекцию MyRandomNumbers:
ForAll( Sequence( 10 ), Collect( MyRandomNumbers, Rand() ) )
ForAll также может использоваться для преобразования значения в другие типы данных и возврата новой таблицы. Например, следующая формула возвращает таблицу следующих 10 дней:
ForAll( Sequence( 10 ), DateAdd( Today(), Value, Days ) )
Количество создаваемых записей округляется вниз до ближайшего целого числа и должно быть в диапазоне от 0 до 50 000. Генерация таблицы с нулевыми записями приводит к пустой таблице.
Заметка
Sequence ограничена 50 000 записей.
Синтаксис
Sequence( Records [, Start [, Step ] ] )
- Records — обязательный аргумент. Количество создаваемых записей. Должно находиться в диапазоне от 0 до 50 000.
- Start — необязательный аргумент. Начальный номер для последовательности. По умолчанию 1.
- Step — необязательный аргумент. Приращение для каждого последующего числа в последовательности. Step может быть отрицательным, чтобы отсчитывать вниз от значения Start. По умолчанию 1.
Примеры
Базовое использование
| Формула | Описание | Результат |
|---|---|---|
| Sequence( 4 ) | Создает таблицу с 4 записями, начиная с 1 по умолчанию и с увеличением на 1 по умолчанию. |  |
| Sequence( 4, 24 ) | Создает таблицу с 4 записями, начиная с 24 и с увеличением на 1 по умолчанию. |  |
| Sequence( 4, 4, -1 ) | Создает таблицу с 4 записями, начиная с 4 и с увеличением на -1, что фактически приводит к уменьшению. |  |
| Sequence( 4, -100, 0.5 ) | Создает таблицу с 4 записями, начиная с -100 и с увеличением на 0,5. |  |
| Sequence( 0.9 ) | Создает пустую таблица, так как счетчик округляется до 0. |  |
| ForAll( Sequence( 4 ), Rand() ) | Создает таблицу случайных чисел из 4 записей. |  Фактические цифры будут отличаться. |
| Concat( Sequence( 5 ), Text( Value ) & " " ) |
Создает строку чисел от 1 до 5. | "1 2 3 4 5 " |
Таблица символов
См. справочник по функции Char, где описывается, как две функции Sequence совместно отображают таблицу символов в двумерном формате.
Шахматная доска
См. справочник по оператору As, как две функции Sequence, работающие вместе, создают шахматную доску в текстовой строке и в двух вложенных коллекциях.