between

Назначение

Находит фрагмент текста между аргументами.

Синтаксис

between(аргумент_1, аргумент_2)

Аргументы

Функция принимает два аргумента.

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

  • endpoint:=yes/no/left/right (по умолчанию — «no»). Позволяет включить в результат оба аргумента/левый аргумент/правый аргумент соответственно.

  • scope:=text/sentence/paragraph/line. Позволяет ограничить область поиска предложением/параграфом/строкой.

  • allow_punct:=yes/no: допускает или запрещает наличие пунктуации между аргументами (по умолчанию — «yes»).

  • match:=first/last/shortest/longest находит первый/последний/самый короткий/самый длинный результат.

  • trim_punct:=yes/no/left/right регулирует только пунктуацию между интервалом и аргументом, который не выводится в результат (по умолчанию — «yes»). Если значение параметра «yes», то он убирает пунктуацию в начале и конце интервала. При значении «no» знаки пунктуации не убираются. При значении «left» убирается только пунктуация в начале интервала. При значении «right» — только в конце интервала.

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

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

Примечание

  1. По умолчанию аргументы не включаются в результат.

  2. Параметр trim_punct игнорируется, когда пунктуция стоит между интервалом и аргументом, который выводится в результат.

  3. Параметр match можно комбинировать со scope:=sentence/text/paragraph/line:

    • match:=shortest, scope:=sentence находит самый короткий результат в предложении.

    • match:=last, scope:=paragraph находит последний результат в параграфе.

    • match:=first, scope:=text находит первый результат в документе.

Примеры

between(a, b, endpoint:=left) находит фрагмент текста между a и b, при этом b выводится в результат.

between("(", ")") находит фрагмент текста между скобками.

between(a, b, scope:=sentence) находит фрагмент текста между a и b в пределах предложения.

between(компания, "тип документа", trim_punct:=left) находит ООО "Ромашка"; в тексте «Компания: ООО "Ромашка"; тип документа: договор аренды».