Klasa BirtComp udostępnia funkcje do
porównywania wartości, na przykład do sprawdzania, czy wartość jest większa lub
mniejsza od innej wartości lub czy wartości są sobie równe. Wszystkie funkcje
zwracają wartości boolowskie. Jest to klasa statyczna. Aplikacja nie
może tworzyć instancji klasy.
Ta funkcja porównuje co
najmniej jedną wartość z zawartością pola.
Składnia
Parametry
źródło
Pole, którego zawartość
jest używana do porównania.
cel
Wartość albo wartości do
znalezienia w źródle.
Wartości zwracane
Wartość boolowska. Wartość true, jeśli
wartość celu odpowiada wartości źródła. Wartość false w pozostałych
przypadkach.
Przykłady
Następujący przykład pozwoli
sprawdzić, czy w polu Kraj znajduje się wartość Kanada, Meksyk albo USA. Jeśli
którykolwiek z tych krajów znajduje się na liście, funkcja zwróci wartość
true.
Następujący przykład pozwala
sprawdzić, czy dni 15 stycznia 2009 r. lub 31 stycznia 2009 r. są wartościami
pola dataPłatności:
Następujący przykład pozwala
sprawdzić, czy konkretne kody produktów są wartościami pola kodProduktu. Jeśli
któraś z wartości występuje w polu, zostanie wyświetlony komunikat
Przestarzałe. W przeciwnym przypadku zostanie wyświetlona taka sama wartość jak
ta, która jest podana w polu kodProduktu.
Za pomocą tej funkcji można sprawdzić,
czy wartość znajduje się między dwiema innymi wartościami.
Składnia
Parametry
źródło
Wartość do sprawdzenia.
cel1
Pierwsza wartość zakresu, z
którym ma być porównywana wartość źródłowa.
cel2
Druga wartość zakresu, z
którym ma być porównywana wartość źródłowa.
Wartości zwracane
Wartość true, jeśli wartość źródłowa
należy do przedziału ustalonego wartościami cel1 i cel2. W przeciwnym razie
wartość false.
Przykłady
Następujące wyrażenia pozwalają
sprawdzić, czy wartości pól znajdują się w określonym przedziale:
Następujący przykład pozwala obliczyć
daty dostawy. Jeśli wartość DataZamówienia wypada w grudniu 2008 r. (czyli
między 2008-12-01 i 2008-12-31), do wartości DataZamówienia zostanie dodane
pięć dni. Jeśli wartość DataZamówienia wypada w innym miesiącu, do wartości
DataZamówienia zostaną dodane trzy dni.
Za pomocą tej funkcji można sprawdzić,
czy łańcuch jest zgodny z innym łańcuchem z uwzględnieniem podanych
warunków.
Składnia
Parametry
źródło1
Pierwszy łańcuch w
porównaniu.
źródło2
Drugi łańcuch w
porównaniu.
ignorujWielkośćLiter
Parametr, dla którego należy
określić wartość true, jeśli porównywanie ma być wykonywane bez
rozróżniania wielkości liter. Należy określić wartość false, aby wykonać
porównywanie z rozróżnianiem wielkości liter.
przytnij
Parametr, dla którego należy
określić wartość true, jeśli przed porównaniem dwóch wartości mają zostać
usunięte odstępy na początku i na końcu. Odstępy znajdujące się wewnątrz
łańcuchów nie są usuwane. Aby w porównaniu uwzględnić odstępy początkowe lub
końcowe, należy dla tego parametru określić wartość false.
Wartości zwracane
Wartość true, jeśli wartość źródło1
odpowiada wartości źródło2; w przeciwnym przypadku wartość false.
Przykłady
W następujących wyrażeniach
porównano łańcuchy, określając różne warunki:
Za pomocą tej funkcji można sprawdzić,
czy wartość jest równa drugiej wartości.
Składnia
Parametry
źródło
Pierwsza wartość
porównania.
cel
Druga wartość porównania.
Wartości zwracane
Wartość true, jeśli wartość źródłowa
jest równa wartości docelowej; w przeciwnym przypadku wartość false.
Przykłady
Następujące wyrażenia pozwalają
sprawdzić, czy wartości pól są równe określonym wartościom:
Za pomocą tej funkcji można sprawdzić,
czy wartość jest większa od drugiej wartości lub czy jest jej równa.
Składnia
Parametry
źródło
Pierwsza wartość porównania.
cel
Druga wartość porównania.
Wartości zwracane
Wartość true, jeśli wartość źródłowa
jest równa wartości docelowej lub od niej większa. W przeciwnym razie wartość
false.
Przykłady
Następujące wyrażenia pozwalają
sprawdzić, czy wartości pól są większe od określonych wartości lub czy są im
równe:
Za pomocą tej funkcji można sprawdzić,
czy wartość jest większa od drugiej wartości.
Składnia
Parametry
źródło
Pierwsza wartość porównania.
cel
Druga wartość porównania.
Wartości zwracane
Wartość true, jeśli wartość źródłowa
jest większa od wartości docelowej; w przeciwnym przypadku wartość false.
Przykłady
Następujące wyrażenia pozwalają
sprawdzić, czy wartości pól są większe od określonych wartości:
Za pomocą tej funkcji można sprawdzić,
czy wartość jest mniejsza od drugiej wartości lub czy jest jej równa.
Składnia
Parametry
źródło
Pierwsza wartość porównania.
cel
Druga wartość porównania.
Wartości zwracane
Wartość true, jeśli wartość źródłowa
jest równa wartości docelowej lub od niej mniejsza. W przeciwnym razie
wartość false.
Przykłady
Następujące wyrażenia pozwalają
sprawdzić, czy wartości pól są mniejsze od określonych wartości lub czy są im
równe:
Za pomocą tej funkcji można sprawdzić,
czy wartość jest mniejsza od drugiej wartości.
Składnia
Parametry
źródło
Pierwsza wartość porównania.
cel
Druga wartość porównania.
Wartości zwracane
Wartość true, jeśli wartość źródłowa
jest większa od wartości docelowej; w przeciwnym przypadku wartość false.
Przykłady
Następujące wyrażenia pozwalają
sprawdzić, czy wartości pól są mniejsze od określonych wartości:
Za pomocą tej funkcji można sprawdzić,
czy łańcuch jest zgodny ze wzorcem. We wzorcu musi być używana składnia dopasowywania wzorca języka SQL.
Składnia
Parametry
źródło
Łańcuch do oceny.
cel
Wzorzec łańcucha do dopasowania. Wzorzec należy ująć w cudzysłów (" "). W trakcie wpisywania
znaków, które mają być dopasowane, należy używać liter o odpowiedniej
wielkości. We wzorcu można użyć następującego znaku specjalnego:
Aby uzyskać dopasowanie znaku procentu
(%) lub podkreślenia (_), należy poprzedzić te znaki dwoma ukośnikami
odwrotnymi (\\). Na przykład aby uzyskać dopasowanie łańcucha S_10, należy użyć
następującego wzorca:
Aby uzyskać dopasowanie do
łańcucha 50%, należy użyć następującego wzorca:
Wartości zwracane
Wartość true, jeśli wartość źródłowa
odpowiada wartości docelowej; w przeciwnym przypadku wartość false.
Przykłady
Następujący przykład zwraca wartość
true dla wartości z pola kodProduktu, które zaczynają się od łańcucha S18:
Następujący przykład zwraca wartość
true dla wartości pola nazwaProduktu, które zawierają podłańcuch Ford
poprzedzony jednym znakiem:
Za pomocą tej funkcji można sprawdzić,
czy łańcuch jest zgodny ze wzorcem. We wzorcu musi być używana składnia wyrażeń
regularnych języka JavaScript.
Składnia
Parametry
źródło
Łańcuch do oceny.
cel
Wzorzec łańcucha do
dopasowania. W wyrażeniach regularnych JavaScript wzorzec jest
podawany przy użyciu pary ukośników (/). Dostępne są wszystkie znaki specjalne,
które są obsługiwane przez wyrażenia regularne JavaScript, takie jak:
Aby zapewnić dokładną zgodność ze
znakiem specjalnym, należy go poprzedzić ukośnikiem odwrotnym (\). Na przykład
aby uzyskać dopasowanie łańcucha S*10, należy użyć następującego wzorca:
Wartości zwracane
Wartość true, jeśli wartość źródłowa
odpowiada wartości docelowej; w przeciwnym przypadku wartość false.
Przykłady
Następujący przykład zwraca wartość
true dla wartości z pola kodProduktu, które zaczynają się od łańcucha S18:
Następujący przykład zwraca
wartość true dla wartości pola nazwaProduktu, które zawierają
podłańcuch Ford:
Za pomocą tej funkcji można sprawdzić,
czy wartość nie znajduje się między dwiema innymi wartościami.
Składnia
Parametry
źródło
Wartość do sprawdzenia.
cel1
Pierwsza wartość zakresu, z
którym ma być porównana wartość źródłowa.
cel2
Druga wartość zakresu, z którym
ma być porównana wartość źródłowa.
Wartości zwracane
Wartość true, jeśli wartość źródłowa
nie należy do przedziału ustalonego wartościami cel1 i cel2. W przeciwnym razie
wartość false.
Przykłady
Następujące wyrażenia pozwalają
sprawdzić, czy wartości pól znajdują się poza określonym przedziałem:
Następujący przykład pozwala obliczyć
daty dostawy. Jeśli wartość DataZamówienia nie wypada w grudniu 2008 r. (czyli
między 2008-12-01 i 2008-12-31), do wartości DataZamówienia zostaną dodane trzy
dni. Jeśli wartość DataZamówienia wypada w grudniu,
do wartości DataZamówienia zostanie dodane pięć dni.
Za pomocą tej funkcji można sprawdzić,
czy wartość nie jest równa drugiej wartości.
Składnia
Parametry
źródło
Pierwsza wartość porównania.
cel
Druga wartość porównania.
Wartości zwracane
Wartość true, jeśli wartość źródłowa
nie jest równa wartości docelowej; w przeciwnym przypadku wartość false.
Przykłady
Następujące wyrażenia pozwalają
sprawdzić, czy wartości pól nie są równe określonym wartościom:
Za pomocą tej funkcji można sprawdzić, czy łańcuch jest niezgodny ze wzorcem. We wzorcu musi być używana składnia dopasowywania wzorca języka SQL.
Składnia
Parametry
źródło
Łańcuch do oceny.
cel
Wzorzec łańcucha używany do porównania. Wzorzec należy ująć w cudzysłów (" "). W trakcie wpisywania
znaków, które mają być dopasowane, należy używać liter o odpowiedniej
wielkości. We wzorcu można użyć następującego znaku specjalnego:
Aby uzyskać dopasowanie znaku procentu
(%) lub podkreślenia (_), należy poprzedzić te znaki dwoma ukośnikami
odwrotnymi (\\). Na przykład aby uzyskać dopasowanie łańcucha S_10, należy użyć
następującego wzorca:
Aby uzyskać dopasowanie do łańcucha
50%, należy użyć następującego wzorca:
Wartości zwracane
Wartość true, jeśli wartość źródłowa
nie jest równa wartości docelowej; w przeciwnym przypadku wartość false.
Przykłady
Następujący przykład zwraca wartość
false dla wartości z pola kodProduktu, które zaczynają się od łańcucha S18:
Następujący przykład zwraca
wartość false dla wartości pola nazwaProduktu, które zawierają
podłańcuch Ford poprzedzony jednym znakiem: