Назад Далее

Класс BirtComp

Класс BirtComp предоставляет функции для сравнения значений, например, чтобы проверить, является ли одно значение равным другому значению, большим или меньшим другого значения. Все функции возвращают булевские значения. Это статический класс. Приложения не могут создавать экземпляры данного класса.

BirtComp.anyOf

Эта функция сравнивает одно или несколько значений с содержимым поля.

Синтаксис

boolean BirtComp.anyOf( source, target1, ..., targetN )

Параметры

source

Поле, содержимое которого применяется для сравнения.

target

Значение или значения, которые требуется найти в поле source.

Возвращает

Boolean. True - если целевое значение совпадает со значением в поле source; в противном случае возвращает false.

Примеры

В следующем примере проверяется, являются ли Canada, Mexico или USA значениями в поле Country (страна). Если в поле окажется одно из этих названий стран, то функция возвратит true.

BirtComp.anyOf(dataSetRow["Country"], "Canada", "Mexico", "USA")

В следующем примере проверяется, являются ли даты 15 января 2009 или 31 января 2009 значениями в поле payDate:

BirtComp.anyOf(dataSetRow["payDate"], "2009-01-15", "2009-01-31")

В следующем примере проверяется, являются ли два определенных кода продуктов значениями в поле productCode. Если в поле окажется любое из этих значений, будет показана строка Obsolete (устарел); в противном случае будет показано значение productCode в том виде, в каком оно отображается в поле.

if (BirtComp.anyOf(dataSetRow["PRODUCTCODE"], "S18_1749", "S18_2248" )){
  displayString = "Obsolete"
}else{
  dataSetRow["PRODUCTCODE"]
}

BirtComp.between

С помощью этой функции можно проверить, попадает ли значение в диапазон между двумя указанными значениями.

Синтаксис

boolean BirtComp.between( source, target1, target2 )

Параметры

source

Проверяемое значение.

target1

Первое значение, задающее диапазон сравниваемых значений.

target2

Второе значение, задающее диапазон сравниваемых значений.

Возвращает

True - если значение source находится между значениями target1 и target; в противном случае возвращается false .

Примеры

В следующих выражениях проверяется, находятся ли значения поля в диапазоне между указанными значениями:

BirtComp.between( row["SalesTotal"], 10000, 20000 )
BirtComp.between( row["CustomerName"], "A", "M" )
BirtComp.between( row["OrderDate"], "2009-01-01", "2009-01-31" )

В следующем примере показано вычисление значений даты доставки. Если значение OrderDate приходится на декабрь 2008 (между 01.12.08 и 31.12.08), то к значению OrderDate необходимо добавить 5 дней. Если значение OrderDate приходится на месяц, отличный от декабря, то к значению OrderDate необходимо добавить 3 дня.

if (BirtComp.between(row["OrderDate"], "2008-12-01", "2008-12-31" )){
  shipDate = BirtDateTime.addDay( row["OrderDate"], 5 )
  }
else{
  ShipDate = BirtDateTime.addDay( row["OrderDate"], 3 )
  }

BirtComp.compareString

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

Синтаксис

boolean BirtComp.compareString( source1, source2, ignoreCase, trim )

Параметры

source1

Значение первой строки из сравниваемых.

source2

Значение второй строки из сравниваемых.

ignoreCase

Укажите true, чтобы сравнивать строки без учета регистра. Укажите false, чтобы сравнивать строки с учетом регистра.

trim

Укажите true для удаления всех начальных или конечных пробелов перед сравнением двух значений. Пробелы в середине строки остаются. Укажите false, если при сравнении требуется учитывать начальные и конечные пробелы.

Возвращает

True - если значение source1 совпадает со значением source2; в противном случае возвращается false.

Примеры

С помощью следующих выражений можно сравнить строки с различными заданными условиями:

BirtComp.compareString( "Jackson", "Jackson", false, false ) // возвращает true
BirtComp.compareString( "Jackson", "jackson", false, true ) // возвращает false
BirtComp.compareString( "Jackson", "jackson", true, false ) // возвращает true
BirtComp.compareString( "Jackson ", "jackson", true, false ) // возвращает false
BirtComp.compareString( "Jackson ", "jackson", true, true ) // возвращает true

BirtComp.equalTo

С помощью этой функции можно проверить, равно ли одно значение другому значению.

Синтаксис

boolean BirtComp.equalTo( source, target )

Параметры

source

Первое значение из сравниваемых.

target

Второе значение из сравниваемых.

Возвращает

True - если значение source равно значению target; в противном случае возвращается false.

Примеры

В следующих выражениях проверяется, равно ли значение поля указанному значению:

BirtComp.equalTo( row["SalesTotal"], 10000 )
BirtComp.equalTo( row["Country"], "France" )
BirtComp.equalTo( row["OrderDate"], "2009-02-15" )

BirtComp.greaterOrEqual

С помощью этой функции можно проверить справедливость утверждения, что одно значение больше или равно другому значению.

Синтаксис

boolean BirtComp.greaterOrEqual( source, target )

Параметры

source

Первое значение из сравниваемых.

target

Второе значение из сравниваемых.

Возвращает

True - если значение source больше или равно значению target; в противном случае возвращается false .

Примеры

В следующих выражениях проверяется справедливость утверждения, что значение поля больше или равно указанному значению:

BirtComp.greaterOrEqual( row["SalesTotal"], 10000 )
BirtComp.greaterOrEqual( row["ProductCode"], "S50_4000" )
BirtComp.greaterOrEqual( row["OrderDate"], "2009-02-15" )

BirtComp.greaterThan

С помощью этой функции можно проверить справедливость утверждения, что одно значение больше другого.

Синтаксис

boolean BirtComp.greaterThan( source, target )

Параметры

source

Первое значение из сравниваемых.

target

Второе значение из сравниваемых.

Возвращает

True - если значение source больше значения target; в противном случае возвращается false.

Примеры

В следующих выражениях проверяется справедливость утверждения, что значение поля больше указанного значения:

BirtComp.greaterThan( row["SalesTotal"], 10000 )
BirtComp.greaterThan( row["CustomerName"], "M" )
BirtComp.greaterThan( row["OrderDate"], "2009-02-15" )

BirtComp.lessOrEqual

С помощью этой функции можно проверить справедливость утверждения, что одно значение меньше или равно другому значению.

Синтаксис

boolean BirtComp.lessOrEqual( source, target )

Параметры

source

Первое значение из сравниваемых.

target

Второе значение из сравниваемых.

Возвращает

True - если значение source меньше или равно значению target; в противном случае возвращается false .

Примеры

В следующих выражениях проверяется справедливость утверждения, что значение поля меньше или равно указанному значению:

BirtComp.lessOrEqual( row["SalesTotal"], 10000 )
BirtComp.lessOrEqual( row["ProductCode"], "S18_4000" )
BirtComp.lessOrEqual( row["OrderDate"], "2009-02-15" )

BirtComp.lessThan

С помощью этой функции можно проверить справедливость утверждения, что одно значение меньше другого.

Синтаксис

boolean BirtComp.lessThan( source, target )

Параметры

source

Первое значение из сравниваемых.

target

Второе значение из сравниваемых.

Возвращает

True - если значение source меньше значения target; в противном случае возвращается false.

Примеры

В следующих выражениях проверяется справедливость утверждения, что значение поля меньше указанного значения:

BirtComp.lessThan( row["SalesTotal"], 10000 )
BirtComp.lessThan( row["CustomerName"], "M" )
BirtComp.lessThan( row["OrderDate"], "2009-02-15" )

BirtComp.like

С помощью этой функции можно проверить, совпадает ли значение строки с шаблоном. Шаблон должен быть задан с использованием синтаксиса шаблонов SQL.

Синтаксис

boolean BirtComp.like( source, target )

Параметры

source

Проверяемое значение строки.

target

Шаблон строки, с которым требуется проверить совпадение. Шаблон должен быть заключен в двойные кавычки (" "). Символы для проверки совпадения необходимо вводить в правильном регистре. В шаблоне можно использовать следующий специальный символ:

*
*

Для сравнения с действительными символами процента (%) или подчеркивания (_) необходимо поместить перед ними два символа обратная косая черта (\\). Например, для совпадения с S_10 используйте следующий шаблон

S\\_10

Для совпадения с 50% используйте следующий шаблон:

50\\%

Возвращает

True - если значение source совпадает со значением target; в противном случае возвращается false.

Примеры

В следующем примере возвращается true, если значение в поле productCode начинается с S18:

BirtComp.like( row["productCode"], "S18%" )

В следующем примере возвращается true, если значение в поле productName содержит подстроку Ford, которой предшествует один символ:

BirtComp.like( row["productName"], "_Ford%" )

BirtComp.match

С помощью этой функции можно проверить, совпадает ли значение строки с шаблоном. Шаблон должен быть задан с использованием синтаксиса регулярного выражения JavaScript.

Синтаксис

boolean BirtComp.match( source, target )

Параметры

source

Проверяемое значение строки.

target

Шаблон строки, с которым требуется проверить совпадение. В синтаксисе регулярного выражения JavaScript указываемый шаблон необходимо поместить между парными символами косая черта (/). Можно использовать любые специальные символы, поддерживаемые регулярными выражениями JavaScript, включая следующие:

*
*
*
*
*

Для совпадения с символом как таковым необходимо поместить перед специальным символом обратную косую черту (\). Например, для поиска совпадений с S*10 используйте следующий шаблон:

/S\*10/

Возвращает

True - если значение source совпадает со значением target; в противном случае возвращается false.

Примеры

В следующем примере возвращается true, если значение в поле productCode начинается с S18:

BirtComp.match( row["productCode"], /^S18/ )

В следующем примере возвращается true, если значение в поле productName содержит подстроку Ford:

BirtComp.match( row["productName"], /Ford/ )

BirtComp.notBetween

С помощью этой функции можно проверить справедливость утверждения, что значение не попадает в диапазон между двумя указанными значениями.

Синтаксис

boolean BirtComp.notBetween( source, target1, target2 )

Параметры

source

Проверяемое значение.

target1

Первое значение, задающее диапазон значений для сравнения.

target2

Второе значение, задающее диапазон значений для сравнения.

Возвращает

True - если значение source не находится между значениями target1 и target; в противном случае возвращается false .

Примеры

В следующих выражениях проверяется, находятся ли значения поля за пределами диапазона между указанными значениями:

BirtComp.notBetween( row["SalesTotal"], 10000, 20000 )
BirtComp.notBetween( row["CustomerName"], "A", "M" )
BirtComp.notBetween( row["OrderDate"], "2009-01-01", "2009-01-31" )

В следующем примере показано вычисление значений даты доставки. Если значение OrderDate не приходится на декабрь 2008 (не находится между 01.12.08 и 31.12.08), то к значению OrderDate необходимо добавить 3 дня. Если значение OrderDate приходится на декабрь, то к значению OrderDate необходимо добавить 5 дней.

if (BirtComp.notBetween(row["OrderDate"], "2008-12-01", "2008-12-31" )){
  shipDate = BirtDateTime.addDay( row["OrderDate"], 3 )
  }
else{
  ShipDate = BirtDateTime.addDay( row["OrderDate"], 5 )
  }

BirtComp.notEqual

С помощью этой функции можно проверить справедливость утверждения, что одно значение не равно другому значению.

Синтаксис

boolean BirtComp.notEqual( source, target )

Параметры

source

Первое значение из сравниваемых.

target

Второе значение из сравниваемых.

Возвращает

True - если значение source не равно значению target; в противном случае возвращается false.

Примеры

В следующих выражениях проверяется справедливость утверждения, что значение поля не равно указанному значению:

BirtComp.notEqual( row["SalesTotal"], 10000 )
BirtComp.notEqual( row["Country"], "France" )
BirtComp.notEqual( row["OrderDate"], "2009-02-15" )

BirtComp.notLike

С помощью этой функции можно проверить, совпадает ли значение строки с шаблоном. Шаблон должен быть задан с использованием синтаксиса шаблонов SQL.

Синтаксис

boolean BirtComp.notLike( source, target )

Параметры

source

Проверяемое значение строки.

target

Шаблон строки для сравнения. Шаблон должен быть заключен в двойные кавычки (" "). Символы для проверки совпадения необходимо вводить в правильном регистре. В шаблоне можно использовать следующий специальный символ:

*
*

Для сравнения с действительными символами процента (%) или подчеркивания (_) необходимо поместить перед ними два символа обратная косая черта (\\). Например, для совпадения с S_10 используйте следующий шаблон

S\\_10

Для совпадения с 50% используйте следующий шаблон:

50\\%

Возвращает

True - если значение source не совпадает со значением target; в противном случае возвращается false.

Примеры

В следующем примере возвращается false, если значение в поле productCode начинается с S18:

BirtComp.notLike( row["productCode"], "S18%" )

В следующем примере возвращается false, если значение в поле productName содержит подстроку Ford, которой предшествует один символ:

BirtComp.notLike( row["productName"], "_Ford%" )

(c) Copyright Actuate Corporation 2013