toparagraph

Назначение

Приводит аргумент к абзацу, где он был найден.

Синтаксис

toparagraph($группа)

Аргументы

Функция принимает один обязательный аргумент — ссылку на именованную группу.

Функция также принимает следующие опциональные именованные параметры:

Параметр

Пояснение

match:=range/arguments

Если аргумент разрывный и находится в нескольких разнесенных предложениях, то в результат идут только эти предложения. При указании именованного параметра match:=range в результат пойдет диапазон от первого фрагмента текста до последнего.

first:=<numeral>

При отсутствии аргументов параметр трактуется как диапазон значений. При наличии аргументов параметр задает смещение начального аргумента.

last:=<numeral>

При отсутствии аргументов параметр трактуется как диапазон значений. При наличии аргументов параметр задает смещение конечного аргумента.

separator:=<string>

Для разделения найденных аргументов можно указать пользовательский разделитель. По умолчанию разделитель равен пробелу (" ").

Примечания

Параметры first и last можно использовать автономно, без указания именованной группы.

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

Текстовое значение.

Примеры

toparagraph(first:=1, last:=3) приводит результат к первым трем абзацам документа.

toparagraph($m, first:=-1, last:=1) приводит именованную группу $m к абзацу до и абзацу после нее.

toparagraph($m, first:=-1, last:=1, match:=range) приводит именованную группу $m к одному абзацу до и одному абзацу после нее в диапазоне от первого фрагмента текста до последнего.