todocument

Назначение

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

Синтаксис

todocument($группа)

Аргументы

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

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

Параметр

Пояснение

first:=<numeral>

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

last:=<numeral>

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

separator:=<string>

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

Примечания

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

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

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

Примеры

todocument(first:=1, last:=2) приводит результат к фрагменту текста в пределах двух первых документов датасета.

todocument($m, first:=1, last:=2) приводит результат к двум документам, которые следуют за документом, где была найдена именованная группа $m.

todocument($m, separator:="\n") приводит именованную группу $m к тексту документа, где она была найдена. При этом найденные фрагменты будут разделены одним переносом строки.