hastextfrag

Назначение

Функция hastextfrag используется для определения числа найденных фрагментов в указанном аргументе; при этом функция позволяет включить/отключить учет регистра, цифр, пунктуации и т.д. в искомых фрагментах.

Синтаксис

hastextfrag(строка,[ignore_capitalization,][ignore_punctuation,][ignore_spaces,][ignore_digits,]фрагмент1,[фрагмент2,]…​)

Аргументы

Функция требует наличия минимум двух аргументов:

  1. строка - строка/текст, в которой ищется требуемый фрагмент;

  2. фрагмент - строка/текст, которая представляет собой искомый фрагмент. Вы также можете указать несколько фрагментов для поиска (фрагмент2, фрагмент3 и т.д.)

Также имеется ряд необязательных дополнительных параметров со значениями true/false (yes/no), которые используются для настройки выражения поиска:

  • ignore_capitalization - используется для того, чтобы не учитывать заглавные буквы при поиске; значение данного параметра по умолчанию равно yes, т.е. если вы не укажете данный аргумент в своем выражении, поиск будет выполняться без учета регистра;

  • ignore_punctuation - используется для того, чтобы не учитывать знаки пунктуации при поиске; значение данного параметра по умолчанию равно yes;

  • ignore_spaces - используется для того, чтобы не учитывать пробелы при поиске; значение данного параметра по умолчанию равно yes;

  • ignore_digits - используется для того, чтобы не учитывать цифры при поиске; значение данного параметра по умолчанию равно yes.

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

Функция возвращает целое число, означающее количество найденных фрагментов в указанном аргументе.

Примеры

  • hastextfrag(["such a nice room"],"room") возвращает 1, поскольку в тексте "such a nice room" слово "room" встречается только 1 раз;

  • hastextfrag(["Such a nice room. Room of my dreams"],"room",ignore_capitalization:=no) возвращает 1, поскольку в тексте слово "room" (не "Room") встречается только 1 раз;

  • hastextfrag(["such a nice room, but next time I’d prefer a different room"],"room") возвращает 2, поскольку в тексте слово "room" встречается 2 раза.