tosentence

Назначение

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

Синтаксис

tosentence($группа)

Аргументы

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

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

Параметр

Пояснение

match:=range/arguments

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

first:=<numeral>

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

last:=<numeral>

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

separator:=<string>

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

Примечания

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

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

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

Примеры

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

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

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