deltextfrag

Назначение

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

Синтаксис

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

Аргументы

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

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

  2. фрагмент - строка/текст, означающий фрагмент, который нужно удалить. Вы можете указать несколько фрагментов, которые нужно удалить (фрагмент2, фрагмент3 и т.д.). Аналогично функции delfrag, функция deltextfrag, в соответствии с определенным алгоритмом, создает сигнатуры, по которым удаляется текст. Соответственно, вторым аргументом данной функции является строка, означающая сигнатуру из отчета узла Удаление фрагментов. Подробнее о сигнатурах можно почитать здесь.

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

  • retain_first - используется в тех случаях, когда необходимо сохранить первый случай использования удаляемого фрагмента.

    Предположим, что имеются тексты со стандартными фразами об авторском праве. Вы не хотите их сохранять, но по определенным причинам хотите указать, что данная фраза действительно использовалась. Вы можете использовать параметр "retain_first:=no"; при этом данная фраза будет удалена, но первый случай ее употребления сохранится.

    Значение данного параметра по умолчанию равно no, т.е. если вы не укажете данный аргумент в своем выражении, первый случай употребления удаляемого фрагмента не будет сохранен.

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

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

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

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

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

Функция возвращает строковое/текстовое значение: строку/текст без удаленного фрагмента/ов (fragment1/2/3…​).

Примеры

  • deltextfrag([Comment],"nice") возвращает все строковые/текстовые значения колонки "Comment" без фрагментов "nice" и "Nice".

  • deltextfrag([Comment],"nice",ignore_capitalization:=no) возвращает все строковые/текстовые значения колонки "Comment" без фрагмента "nice".

  • deltextfrag([Comment],[Comment]) возвращает null, поскольку данное выражение не имеет смысла (невозможно удалить колонку из колонки).