near
Назначение
Для поиска последовательности аргументов в произвольном порядке на определенном расстоянии используется функция near().
Аргументы
Функция принимает несколько аргументов:
-
опциональный именованный параметр расстояние позволяет указать максимальное расстояние (в токенах) между соседними аргументами. По умолчанию данный параметр равен 1. Если параметр равен 0, запрещается наличие пунктуации между аргументами;
-
аргумент_1, аргумент_2 и т.д. - искомые аргументы.
Функция также поддерживает следующие опциональные именованные параметры:
-
range определяет точную длину последовательности в токенах, min_range определяет минимальную длину, max_range - максимальную;
-
distance определяет точную разницу в позициях между первым и последним токеном последовательности, min_distance определяет минимальную разницу, max_distance - максимальную;
-
gap определяет точное количество токенов между аргументами последовательности, min_gap определяет минимальное количество, max_gap - максимальное;
-
interval определяет точную разницу в позициях между соседними аргументами последовательности, min_interval определяет минимальную разницу, max_interval - максимальную;
-
allow_punct:=yes/no: допускает или запрещает наличие пунктуации между аргументами (значение по умолчанию - "yes");
-
allow_space:=yes/no допускает или запрещает наличие пробела между аргументами (значение по умолчанию - "yes");
-
match:=range извлекает фрагмент текста от первого до последнего найденного аргумента.