Poprzedni Następny

Klasa BirtStr

Klasa BirtStr udostępnia funkcje, które pozwalają na modyfikowanie łańcuchów tekstowych, takie jak konkatenacja, usuwanie zbędnych spacji, pobieranie części łańcucha oraz wyświetlanie łańcuchów małymi lub wielkimi literami. Jest to klasa statyczna. Aplikacja nie może tworzyć instancji klasy.

BirtStr.charLength

Ta funkcja zwraca długość danego łańcucha.

Składnia

integer BirtStr.charLength( string źródło )

Parametr

źródło

Łańcuch. Łańcuch do wartościowania.

Wartość zwracana

Liczba całkowita. Liczba znaków w określonym łańcuchu.

Przykłady

Następujący przykład zwraca długość konkretnego łańcucha:

BirtStr.charLength( "Jan Kowalski" ) // zwraca 12

Następujący przykład zwraca długość każdej wartości w polu NazwaKlienta:

BirtStr.charLength( row["NazwaKlienta"] )

BirtStr.concat

Ta funkcja zwraca łańcuch powstały z konkatenacji określonych łańcuchów.

Składnia

string BirtStr.concat( string źródło1, ..., źródłoN )

Parametr

źródło1, ..., źródłoN

Łańcuch. Łańcuchy do konkatenacji.

Wartość zwracana

Łańcuch. Łańcuch będący wynikiem konkatenacji serii łańcuchów.

Przykład

Następujący przykład zwraca pełny adres powstały w wyniku konkatenacji wartości z wielu pól:

BirtStr.concat( row["WierszAdresu1"], ", ", row["WierszAdresu2"], ", ", row["Miasto"], " ", row["KodPocztowy"], "row["Województwo"], ", ", row["Kraj"] )

BirtStr.indexOf

Ta funkcja zwraca pozycję określonego podłańcucha w danym łańcuchu.

Składnia

integer BirtStr.indexOf( string cel, string źródło, integer start )

Parametry

cel

Łańcuch. Wyszukiwany podłańcuch. Mechanizm wyszukiwania uwzględnia wielkość znaków.

źródło

Łańcuch. Łańcuch, w którym będzie wyszukiwany określony podłańcuch.

start

Liczba całkowita. Właściwość opcjonalna. Pozycja w łańcuchu źródłowym, od której zostanie rozpoczęte wyszukiwanie. Pominięcie tego argumentu oznacza, że funkcja rozpocznie wyszukiwanie od pierwszego znaku łańcucha.

Wartość zwracana

Liczba całkowita. Liczbowe określenie położenia podłańcucha w łańcuchu. Pierwszy znak łańcucha ma indeks 0. Jeśli podłańcuch nie zostanie znaleziony, funkcja zwróci wartość -1.

Przykłady

Następujący przykład zwraca pozycje określonych znaków w konkretnych łańcuchach:

BirtStr.indexOf( " ", "Jan Kowalski" ) // zwraca 3
BirtStr.indexOf( "-", "ModelA-1234-567" ) // zwraca 6
BirtStr.indexOf( "-", "ModelA-1234-567", 7 ) // zwraca 11

W następującym przykładzie funkcje BirtStr.indexOf( ) i BirtStr.left( ) zostaną użyte łącznie w celu wyświetlenia znaków, które poprzedzają spację w nazwie klienta. Funkcja BirtStr.left( ) pozwala na wyodrębnienie podłańcucha o określonej długości, rozpoczynając od pierwszego znaku. W tym przykładzie długość podłańcucha do wyświetlenia jest równa liczbie opisującej pozycję spacji.

pozycjaSpacji = BirtStr.indexOf( " ", row["nazwaKlienta"] );
wyswietlaneImie = BirtStr.left( row["nazwaKlienta"], pozycjaSpacji );

Jeśli klient nazywa się Jan Kowalski, wyrażenie zwróci wartość Jan.

BirtStr.left

Ta funkcja wyodrębnia podłańcuch o określonej długości z łańcucha, rozpoczynając od znaku umieszczonego skrajnie po lewej stronie (pierwszego).

Składnia

string BirtStr.left( string źródło, integer n )

Parametry

źródło

Łańcuch. Łańcuch, z którego ma zostać wyodrębniony podłańcuch.

n

Liczba całkowita. Liczba znaków do wyodrębnienia, rozpoczynając od pierwszego.

Wartość zwracana

Łańcuch. Podłańcuch o konkretnej długości.

*
*
*

Przykłady

W następującym przykładzie zostaną zwrócone podłańcuchy konkretnych łańcuchów o podanej długości:

BirtStr.left( "Jan Kowalski", 3 ) // zwraca „Jan”
BirtStr.left( "Jan Kowalski", 12 ) // zwraca „Jan Kowalski”

W następującym przykładzie funkcje BirtStr.indexOf( ) i BirtStr.left( ) zostaną użyte łącznie w celu wyświetlenia znaków, które poprzedzają spację w nazwie klienta. Funkcja BirtStr.left( ) pozwala na wyodrębnienie podłańcucha o określonej długości, rozpoczynając od pierwszego znaku. W tym przykładzie długość podłańcucha do wyświetlenia jest równa liczbie opisującej pozycję spacji.

pozycjaSpacji = BirtStr.indexOf( " ", row["nazwaKlienta"] );
wyswietlaneImie = BirtStr.left( row["nazwaKlienta"], pozycjaSpacji );

Jeśli klient nazywa się Jan Kowalski, wyrażenie zwróci wartość Jan.

BirtStr.right

Ta funkcja wyodrębnia podłańcuch o określonej długości z łańcucha, rozpoczynając od znaku umieszczonego skrajnie po prawej stronie (ostatniego).

Składnia

String BirtStr.right( String źródło, integer n )

Parametry

źródło

Łańcuch. Łańcuch, z którego ma zostać wyodrębniony podłańcuch.

n

Liczba całkowita. Liczba znaków do wyodrębnienia, rozpoczynając od ostatniego.

Wartość zwracana

Łańcuch. Podłańcuch o konkretnej długości.

*
*
*

Przykłady

W następującym przykładzie zostaną zwrócone podłańcuchy konkretnych łańcuchów o podanej długości:

BirtStr.right( "Jan Kowalski", 8 ) // zwraca „Kowalski”
BirtStr.right( "Jan Kowalski", 12 ) // zwraca „Jan Kowalski”

W następujących przykładach funkcje BirtStr.right( ), BirtStr.indexOf( ) i BirtStr.charLength( ) zostaną użyte łącznie w celu wyświetlenia znaków, które następują po spacji w nazwie klienta. Na potrzeby przykładu przyjęto założenie, że liczba znaków po myślniku jest zmienna. Z tego powodu liczba znaków do wyświetlenia to długość całego łańcucha (zwrócona przez funkcję BirtStr.charLength( )) minus długość podłańcucha liczonego do miejsca wystąpienia myślnika (zwrócona przez funkcję BirtStr.indexOf( )).

pozycjaSpacji = BirtStr.indexOf( " ", row["nazwaKlienta"] );
wyswietlaneNazwisko = BirtStr.right( row["nazwaKlienta"], (BirtStr.charLength( row["nazwaKlienta"] - (pozycjaSpacji + 1)) )

Jeśli klient nazywa się Jan Kowalski, wyrażenie zwróci wartość Kowalski. Jeśli klient nazywa się Adam Malinowski, wyrażenie zwróci wartość Malinowski.

BirtStr.search

Ta funkcja zwraca pozycję określonego podłańcucha w danym łańcuchu. Podłańcuch może zawierać znaki wieloznaczne.

Składnia

integer BirtStr.search( string wzorzec, string źródło, integer indeks )

Parametry

wzorzec

Łańcuch. Wzorzec łańcucha do wyszukania. Mechanizm wyszukiwania nie uwzględnia wielkości znaków. We wzorcu można użyć następujących znaków wieloznacznych:

*
Znak gwiazdki (*) oznacza dowolną (także zerową) liczbę znaków, w tym spacji. Na przykład wyrażenie t*n odpowiada słowom ten, tamten i tran.
*

Aby we wzorcu umieścić literał gwiazdki lub znaku zapytania, należy poprzedzić te znaki dwoma ukośnikami odwrotnymi (\\). Na przykład aby znaleźć podłańcuch R*10, należy wprowadzić następujący wzorzec łańcucha:

"R\\*10"

źródło

Łańcuch. Łańcuch, w którym będzie wyszukiwany określony podłańcuch.

index

Liczba całkowita. Właściwość opcjonalna. Pozycja w łańcuchu źródłowym, od której zostanie rozpoczęte wyszukiwanie. Pominięcie tego argumentu oznacza, że funkcja rozpocznie wyszukiwanie od pierwszego znaku łańcucha.

Wartość zwracana

Liczba całkowita. Liczbowe określenie położenia podłańcucha w łańcuchu. Pierwszy znak łańcucha ma indeks 0. Jeśli podłańcuch nie zostanie znaleziony, funkcja zwróci wartość -1.

Przykłady

Następujący przykład zwraca pozycję określonych wzorców łańcucha w podanych łańcuchach:

BirtStr.search( "XM?", "XMS-ModelA-1234-567" ) // zwraca 0
BirtStr.search( "ModelA*", "XMS-ModelA-1234-567" ) // zwraca 4
BirtStr.search( "-", "XMS-ModelA-1234-567", 4 ) // zwraca 10

Następujący przykład pozwala wyszukać wzorzec łańcucha S*A w każdej wartości pola KodProduktu. Jeśli kod produktu to KBS5412A, wyrażenie zwróci wartość 2.

BirtStr.search( "S*A", row["KodProduktu"] )

W następującym przykładzie funkcja BirtStr.search( ) zostanie wykorzystana łącznie z funkcją BirtStr.left( ) w celu wyświetlenia znaków, które poprzedzają łańcuch -Model* w nazwie produktu. Funkcja BirtStr.left( ) pozwala na wyodrębnienie podłańcucha o określonej długości, rozpoczynając od pierwszego znaku. W tym przykładzie długość podłańcucha do wyświetlenia jest równa liczbowej pozycji wzorca łańcucha.

polozenieWzorcaLancucha = BirtStr.search( "-Model*", row["nazwaProduktu"] );
wyswietlanyLancuch = BirtStr.left( row["nazwaProduktu"], polozenieWzorcaLancucha );

Jeśli produkt ma nazwę XMS-ModelA-1234, wyrażenie zwróci łańcuch XMS.

BirtStr.toLower

Ta funkcja służy do przekształcania wszystkich liter łańcucha w małe litery.

Składnia

string BirtStr.toLower( string źródło )

Parametr

źródło

Łańcuch. Łańcuch do przekształcenia w małe litery.

Wartość zwracana

Łańcuch. Określony łańcuch zapisany wyłącznie przy użyciu małych liter.

Przykład

Następujący przykład pozwala wyświetlić wszystkie wartości pola liniaProduktów małymi literami:

BirtStr.toLower( row["liniaProduktów"] )

BirtStr.toUpper

Ta funkcja służy do przekształcania wszystkich liter łańcucha w duże litery.

Składnia

string BirtStr.toUpper( string źródło )

Parametr

źródło

Łańcuch. Łańcuch do przekształcenia w wielkie litery.

Wartość zwracana

Łańcuch. Określony łańcuch zapisany wyłącznie przy użyciu wielkich liter.

Przykład

Następujący przykład pozwala wyświetlić wszystkie wartości pola nazwaKlienta wielkimi literami:

BirtStr.toUpper( row["nazwaKlienta"] )

BirtStr.trim

Ta funkcja zwraca łańcuch, z którego zostały usunięte wszystkie początkowe i końcowe znaki odstępu. Znaki odstępu, które znajdują się między słowami, nie są usuwane.

Składnia

string BirtStr.trim( string źródło )

Parametr

źródło

Łańcuch. Łańcuch, z którego mają zostać usunięte początkowe i końcowe znaki odstępu.

Wartość zwracana

Łańcuch. Łańcuch, z którego zostały usunięte wszystkie początkowe i końcowe znaki odstępu.

Przykład

W następującym przykładzie funkcja BirtStr.trim( ) zostanie użyta do usunięcia wszystkich początkowych i końcowych znaków odstępu z wartości w polach danych Imię oraz Nazwisko.

BirtStr.trim( row["Imię"] ) + " " + BirtStr.trim( row["Nazwisko"] )

BirtStr.trimLeft

Ta funkcja zwraca łańcuch, z którego zostały usunięte wszystkie początkowe i końcowe znaki odstępu. Znaki odstępu, które znajdują się między słowami, nie są usuwane.

Składnia

string BirtStr.trimLeft( string źródło )

Parametr

źródło

Łańcuch. Łańcuch, z którego mają zostać usunięte początkowe znaki odstępu.

Wartość zwracana

Łańcuch. Łańcuch, z którego zostały usunięte wszystkie początkowe znaki odstępu.

Przykład

Następujący przykład pozwala wykonać konkatenację literału łańcuchowego z każdą wartością pola nazwaKlienta. Funkcja BirtStr.trimLeft( ) pozwala na usunięcie wszystkich znaków odstępu, które poprzedzają wartość nazwaKlienta. Dzięki temu między literałem łańcuchowym i wartością nazwaKlienta nie będzie żadnych dodatkowych znaków odstępu.

"Nazwa klienta: " + BirtStr.trimLeft( row["nazwaKlienta"] )

BirtStr.trimRight

Ta funkcja zwraca łańcuch, z którego zostały usunięte wszystkie końcowe znaki odstępu. Znaki odstępu, które znajdują się między słowami, nie są usuwane.

Składnia

string BirtStr.trimRight( string źródło )

Parametr

źródło

Łańcuch. Łańcuch, z którego mają zostać usunięte wszystkie końcowe znaki odstępu.

Wartość zwracana

Łańcuch. Łańcuch, z którego zostały usunięte wszystkie końcowe znaki odstępu.

Przykład

Następujący przykład pozwala wykonać konkatenację każdej wartości w polu Komentarz ze znakiem średnika oraz wartością z pola Działanie. Funkcja BirtStr.trimRight( ) pozwala na usunięcie wszystkich znaków odstępu, które następują po łańcuchu z pola Komentarz. Dzięki temu między tym łańcuchem i średnikiem nie będzie żadnych dodatkowych znaków odstępu.

BirtStr.trimRight( row["Komentarz"]) + "; " + row["Działanie"] )

(c) Copyright Actuate Corporation 2013