line

Назначение

Находит документы в пределах указанного числа строк.

Синтаксис

line([число_строк, ] [аргумент_1] [, аргумент_2])

Аргументы

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

line() принимает в качестве аргументов слова и фразы в любой форме, а также другие функции поиска слов или последовательностей.

Опциональный параметр число_строк позволяет указать максимально допустимое число строк, в пределах которого нужно искать аргументы или члены последовательности. При его отсутствии функция ищет аргументы в пределах одной строки.

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

  • whole:=yes позволяет извлекать полностью те строки, которые содержат аргументы запроса.

  • match:=arguments извлекает только аргументы, указанные в запросе (значение по умолчанию).

  • match:=range извлекает фрагмент текста от первого до последнего найденного аргумента.

  • match:=inverse возвращает весь фрагмент текста кроме указанных аргументов.

  • min_length задает минимальную длину строки в токенах.

  • max_length задает максимальную длину строки в токенах.

Примечание

При работе функции line() пустые строки игнорируются.

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

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

Примеры

line(3, математика, победитель) найдет все упоминания слов «математика» и «победитель» в пределах трех непустых строк текста.

line(безопасность, дорожное, движение, whole:=yes) найдет строки, которые состоят из слов «безопасность», «дорожное», «движение» в пределах одной строки.

line(университет, match:=range) найдет все упоминания слова «университет» и извлечет строки, где оно упоминается, полностью.

line(университет, min_length:=2, max_length:=10) найдет все упоминания слова «университет» в строках длиной от 2 до 10 токенов.

line(not университет) найдет строки, где нет слова «университет».

line(количество, match:=inverse) найдет все строки, где есть слово «количество», и подкрасит все строку кроме слова «количество».