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.
Ta funkcja zwraca długość danego łańcucha.
Składnia
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:
Następujący przykład zwraca długość
każdej wartości w polu NazwaKlienta:
Ta funkcja zwraca
łańcuch powstały z konkatenacji określonych łańcuchów.
Składnia
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"] )
Ta funkcja zwraca
pozycję określonego podłańcucha w danym łańcuchu.
Składnia
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:
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.
Jeśli
klient nazywa się Jan Kowalski, wyrażenie zwróci wartość Jan.
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
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:
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.
Jeśli
klient nazywa się Jan Kowalski, wyrażenie zwróci wartość Jan.
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
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:
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( )).
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.
Ta funkcja zwraca pozycję określonego podłańcucha w danym łańcuchu. Podłańcuch może zawierać znaki wieloznaczne.
Składnia
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:
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ó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:
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.
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.
Jeśli
produkt ma nazwę XMS-ModelA-1234, wyrażenie zwróci łańcuch
XMS.
Ta funkcja służy do przekształcania
wszystkich liter łańcucha w małe litery.
Składnia
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:
Ta funkcja służy do przekształcania
wszystkich liter łańcucha w duże litery.
Składnia
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:
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
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.
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
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.
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
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.