regex

Назначение

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

Данная функция является алиасом функции find с необязательным параметром regex:=true.

Синтаксис

regex(строка,строка)

Аргументы

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

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

  • case := yes/no - для поиска с учетом регистра (по умолчанию "истина");

  • wholeword := yes/no - для поиска по целым словам (по умолчанию "ложь");

  • wholetext := yes/no - для поиска по целым текстам (по умолчанию "ложь").

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

Функция возвращает значение истина/да, если первая строка включает вторую строку, иначе возвращает ложь/нет.

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

Примеры

Для следующего текста о преступлениях:

FAIRFAX COUNTY POLICE ARE INVESTIGATING A ROBBERY THAT OCCURRED AT THE 7-ELEVEN STORE LOCATED AT 5624 OX ROAD, IN THE FAIRFAX STATION AREA, ABOUT 3:00 AM FRIDAY. A 51 YEAR OLD BURKE AREA MAN, EMPLOYED AS A CLERK AT THE STORE, OBSERVED TWO MEN, WHO APPEARED TO BE INTOXICATED, ENTER THE STORE. ONE MAN PURCHASED ITEMS, LEFT THE STORE, THEN WAITED IN THE CAR FOR THE SECOND MAN WHO WAS STANDING BY THE ATM. THE SECOND MAN THEN TURNED AROUND, APPROACHED THE COUNTER, DISPLAYED A HANDGUN, AND DEMANDED MONEY. AFTER AN UNDISCLOSED AMOUNT OF MONEY WAS GIVEN TO HIM, THE MAN FLED IN A VEHICLE THAT WAS DRIVEN BY A THIRD MAN. THE FIRST MAN WAS DESCRIBED AS WHITE, IN HIS TWENTIES, FIVE FEET TEN INCHES TALL, WITH LONG BUSHY HAIR. THE SECOND SUSPECT IS DESCRIBED AS HISPANIC, ALSO IN HIS TWENTIES, SIX FEET TALL WITH LONG STRAIGHT BROWN HAIR AND UNSHAVEN. ANYONE WITH INFORMATION IS ASKED TO CALL FAIRFAX COUNTY POLICE AT (703) 691-2131.

результаты работы функции будут следующими:

  • regex([Description],"bribery") возвращает false, т.к. преступление bribery не упоминается в тексте;

  • regex([Description],"robbery") возвращает false, т.к. преступление robbery упоминается в тексте, но написано заглавными буквами; если параметр casense не используется, это означает, что по умолчанию поиск выполняется с учетом регистра;

  • regex([Description],"robbery",casesens:=false) возвращает false, т.к. преступление robbery упоминается в тексте, и используется параметр casesens:=false, что позволяет найти ROBBERY.