Класс BirtComp предоставляет функции для сравнения значений, например, чтобы проверить, является ли одно значение равным другому значению, большим или меньшим другого значения. Все функции возвращают булевские значения. Это статический класс. Приложения не могут создавать экземпляры данного класса.
Эта функция сравнивает одно или несколько значений с содержимым поля.
Синтаксис
Параметры
source
Поле, содержимое которого применяется для сравнения.
target
Значение или значения, которые требуется найти в поле source.
Возвращает
Boolean. True - если целевое значение совпадает со значением в поле
source; в противном случае возвращает false.
Примеры
В следующем примере проверяется, являются ли Canada, Mexico или USA значениями в поле Country (страна). Если в поле окажется одно из этих названий стран, то функция возвратит true.
В следующем примере проверяется, являются ли даты 15 января 2009 или 31 января 2009 значениями в поле payDate:
В следующем примере проверяется, являются ли два определенных кода продуктов значениями в поле productCode. Если в поле окажется любое из этих значений, будет показана строка Obsolete (устарел); в противном случае будет показано значение productCode в том виде, в каком оно отображается в поле.
С помощью этой функции можно проверить, попадает ли значение в диапазон между двумя указанными значениями.
Синтаксис
Параметры
source
Проверяемое значение.
target1
Первое значение, задающее диапазон сравниваемых значений.
target2
Второе значение, задающее диапазон сравниваемых значений.
Возвращает
True - если значение source находится между значениями target1 и target; в противном случае возвращается false .
Примеры
В следующих выражениях проверяется, находятся ли значения поля в диапазоне между указанными значениями:
В следующем примере показано вычисление значений даты доставки. Если значение OrderDate приходится на декабрь 2008 (между 01.12.08 и 31.12.08), то к значению OrderDate необходимо добавить 5 дней. Если значение OrderDate приходится на месяц, отличный от декабря, то к значению OrderDate необходимо добавить 3 дня.
С помощью этой функции можно проверить, совпадает ли значение строки со значением другой строки при указанных условиях.
Синтаксис
Параметры
source1
Значение первой строки из сравниваемых.
source2
Значение второй строки из сравниваемых.
ignoreCase
Укажите true, чтобы сравнивать строки без учета регистра. Укажите false, чтобы сравнивать строки с учетом регистра.
trim
Укажите true для удаления всех начальных или конечных пробелов перед сравнением двух значений. Пробелы в середине строки остаются. Укажите false, если при сравнении требуется учитывать начальные и конечные пробелы.
Возвращает
True - если значение source1 совпадает со значением source2; в противном случае возвращается false.
Примеры
С помощью следующих выражений можно сравнить строки с различными заданными условиями:
С помощью этой функции можно проверить, равно ли одно значение другому значению.
Синтаксис
Параметры
source
Первое значение из сравниваемых.
target
Второе значение из сравниваемых.
Возвращает
True - если значение source равно значению target; в противном случае возвращается false.
Примеры
В следующих выражениях проверяется, равно ли значение поля указанному значению:
С помощью этой функции можно проверить справедливость утверждения, что одно значение больше или равно другому значению.
Синтаксис
Параметры
source
Первое значение из сравниваемых.
target
Второе значение из сравниваемых.
Возвращает
True - если значение source больше или равно значению target; в противном случае возвращается false .
Примеры
В следующих выражениях проверяется справедливость утверждения, что значение поля больше или равно указанному значению:
С помощью этой функции можно проверить справедливость утверждения, что одно значение больше другого.
Синтаксис
Параметры
source
Первое значение из сравниваемых.
target
Второе значение из сравниваемых.
Возвращает
True - если значение source больше значения target; в противном случае возвращается false.
Примеры
В следующих выражениях проверяется справедливость утверждения, что значение поля больше указанного значения:
С помощью этой функции можно проверить справедливость утверждения, что одно значение меньше или равно другому значению.
Синтаксис
Параметры
source
Первое значение из сравниваемых.
target
Второе значение из сравниваемых.
Возвращает
True - если значение source меньше или равно значению target; в противном случае возвращается false .
Примеры
В следующих выражениях проверяется справедливость утверждения, что значение поля меньше или равно указанному значению:
С помощью этой функции можно проверить справедливость утверждения, что одно значение меньше другого.
Синтаксис
Параметры
source
Первое значение из сравниваемых.
target
Второе значение из сравниваемых.
Возвращает
True - если значение source меньше значения target; в противном случае возвращается false.
Примеры
В следующих выражениях проверяется справедливость утверждения, что значение поля меньше указанного значения:
С помощью этой функции можно проверить, совпадает ли значение строки с шаблоном. Шаблон должен быть задан с использованием синтаксиса шаблонов SQL.
Синтаксис
Параметры
source
Проверяемое значение строки.
target
Шаблон строки, с которым требуется проверить совпадение. Шаблон должен быть заключен в двойные кавычки (" "). Символы для проверки совпадения необходимо вводить в правильном регистре. В шаблоне можно использовать следующий специальный символ:
Для сравнения с действительными символами процента (%) или подчеркивания (_) необходимо поместить перед ними два символа обратная косая черта (\\). Например, для совпадения с S_10 используйте следующий шаблон
Для совпадения с 50% используйте следующий шаблон:
Возвращает
True - если значение source совпадает со значением target; в противном случае возвращается false.
Примеры
В следующем примере возвращается true, если значение в поле productCode начинается с S18:
В следующем примере возвращается true, если значение в поле productName содержит подстроку Ford, которой предшествует один символ:
С помощью этой функции можно проверить, совпадает ли значение строки с шаблоном. Шаблон должен быть задан с использованием синтаксиса регулярного выражения JavaScript.
Синтаксис
Параметры
source
Проверяемое значение строки.
target
Шаблон строки, с которым требуется проверить совпадение. В синтаксисе регулярного выражения JavaScript указываемый шаблон необходимо поместить между парными символами косая черта (/). Можно использовать любые специальные символы, поддерживаемые регулярными выражениями JavaScript, включая следующие:
Для совпадения с символом как таковым необходимо поместить перед
специальным символом обратную косую черту (\). Например, для поиска совпадений с S*10 используйте следующий шаблон:
Возвращает
True - если значение source совпадает со значением target; в противном случае возвращается false.
Примеры
В следующем примере возвращается true, если значение в поле productCode начинается с S18:
В следующем примере возвращается true, если значение в поле productName содержит подстроку Ford:
С помощью этой функции можно проверить справедливость утверждения, что значение не попадает в диапазон между двумя указанными значениями.
Синтаксис
Параметры
source
Проверяемое значение.
target1
Первое значение, задающее диапазон значений для сравнения.
target2
Второе значение, задающее диапазон значений для сравнения.
Возвращает
True - если значение source не находится между значениями target1 и target; в противном случае возвращается false .
Примеры
В следующих выражениях проверяется, находятся ли значения поля за пределами диапазона между указанными значениями:
В следующем примере показано вычисление значений даты доставки. Если значение OrderDate не приходится на декабрь 2008 (не находится между 01.12.08 и 31.12.08), то к значению OrderDate необходимо добавить 3 дня. Если значение OrderDate приходится на декабрь, то к значению OrderDate необходимо добавить 5 дней.
С помощью этой функции можно проверить справедливость утверждения, что одно значение не равно другому значению.
Синтаксис
Параметры
source
Первое значение из сравниваемых.
target
Второе значение из сравниваемых.
Возвращает
True - если значение source не равно значению target; в противном случае возвращается false.
Примеры
В следующих выражениях проверяется справедливость утверждения, что значение поля не равно указанному значению:
С помощью этой функции можно проверить, совпадает ли значение строки с
шаблоном. Шаблон должен быть задан с использованием синтаксиса шаблонов SQL.
Синтаксис
Параметры
source
Проверяемое значение строки.
target
Шаблон строки для сравнения. Шаблон должен быть заключен в двойные кавычки (" "). Символы для проверки совпадения необходимо вводить в правильном регистре. В шаблоне можно использовать следующий специальный символ:
Для сравнения с действительными символами процента (%) или подчеркивания (_) необходимо поместить перед ними два символа обратная косая черта (\\). Например, для совпадения с S_10 используйте следующий шаблон
Для совпадения с 50% используйте следующий шаблон:
Возвращает
True - если значение source не совпадает со значением target; в противном случае возвращается false.
Примеры
В следующем примере возвращается false, если значение в поле productCode начинается с S18:
В следующем примере возвращается false, если значение в поле productName содержит подстроку Ford, которой предшествует один символ: