choose

Назначение

Для поиска первого, последнего, самого короткого или самого длинного результата аргумента в определенном диапазоне документа используется функция choose().

Синтаксис

choose(аргумент, критерий_выбора)

Аргументы

Функция принимает один обязательный аргумент — это строковое значение или pdl-функцию. Функция также принимает следующие именованные параметры:

mode:=shortest/longest/first/last находит самый короткий/самый длинный/первый/последний результат.
scope:=sentence/line/paragraph/text задает диапазон поиска результата: предложение/строка/параграф/текст. По умолчанию scope:=text.

Чтобы сузить поиск, можно перечислить значения параметра mode через знак нижнего подчеркивания «_».

Возвращаемое значение

Документы, соответствующие запросу.

Примеры

choose(entity(Companies), mode:=first) находит первую упомянутую компанию в документе.

choose(договор, mode:=last, scope:=paragraph) находит последнее упоминание слова «договор» в документе.