inc
Назначение
Функция inc генерирует автоматически приращенное (инкрементированное) число при каждом запуске функции.
Название функции inc - сокращение от слова increment (приращение). В PolyAnalyst Grid это совпадает с каждой оценкой строки в таких узлах, как Производные колонки или Фильтрация строк.
В техническом плане функция inc не ограничивается приращением на 1. Вы указываете значение, на которое нужно увеличить функцию.
В проекте функцию inc можно использовать во многих различных ситуациях. Если вы хотите идентифицировать каждую строку таблицы, используйте узел Производные колонки для создания новой колонки, которая содержит уникальный идентификатор каждой строки. Этот идентификатор уникален, поскольку функция inc не будет возвращать одно и то же значение для каждой строки, т.к. оно всегда приращается на одну строку.
Обратите внимание, что функция inc не является ни единственным, ни уникальным методом назначения первичного ключа (уникального идентификатора) для таблицы; вы можете сделать это, просто импортируя таблицу с помощью опции "Идентификатор строки" в настройках узла источника данных. Для получения подробной информации по определению уникального идентификатора см. раздел по узлам источников данных в справочнике узлов. В связи этим функцию inc предпочтительно использовать тогда, когда невозможно назначить новую таблицу, используя узлы PolyAnalyst (что означает, что была импортирована), или выполняете пересортировку записей.
Работа функции inc зависит от естественного порядка строк в оцениваемой таблице. Например, если вы используете узел Сортировка строк, чтобы изменить таблицу, перед тем, как использовать узел Производные колонки, чтобы добавить колонку, содержащую выходные данные функции inc, то в итоге вы будете назначать новые уникальные значения в новой колонке для каждой строки. До оценки колонки в узле Производные колонки или Фильтрация не нужно ожидать от функции inc тех же результатов, если порядок строк в этой колонке был каким-либо образом изменен.
Если вы используете функцию inc несколько раз в одном выражении, обратите внимание, что функция inc оценивается ОДИН РАЗ для всего выражения на строку. Она не оценивается при каждом использовании ее в выражении.
Функция inc всегда начинается со значения 0. Вы можете получить другое значение, используя возвращаемое значение как числовой аргумент.
Можно также использовать отрицательное приращенное значение и получить эффект убывания. Аргумент, включенный в функцию inc добавляется к предыдущему возвращаемому значению. Следовательно, если включить отрицательное значение, то возвращаемое значение снизится на это число.
Эквивалентная функция dec (от англ. decrement - убывание) в PolyAnalyst Grid отсутствует, следовательно получить желаемое в данном случае поведение можно только с помощью описанного способа.
Функция inc - математическая.
Аргументы
Функция требует наличия одного аргумента, представленного целым числом.
Если аргумент представлен не целым числом, то появляется сообщение об ошибке.
Вы также можете добавить второй необязательный аргумент для настройки условия генерации приращенных чисел. Например, можно настроить функцию на генерирование приращенных чисел только для определенной группы значений в колонках.
Возвращаемое значение
Если аргумент нулевой, то функция inc возвращает 0.
В противном случае функция inc возвращает целое число, которое увеличивается на значение аргумента приращения при каждом запуске функции для полной строки данных (не для вызова функции в выражении).
При использовании второго необязательного аргумента функция возвращает 0, если удовлетворено указанное условие.