Třída BirtStr poskytuje funkce pro manipulaci s řetězci, například skládání řetězců, ořezávání nadbytečných mezer, získávání částí řetězce a zobrazování řetězců malými či velkými písmeny. Tato třída je statická. Aplikace nemůže vytvořit instance této třídy.
Tato funkce vrací délku daného řetězce.
Syntaxe
Parametr
zdroj
Hodnota typu String. Řetězec, který má být vyhodnocen.
Vrací
Hodnota typu Integer. Počet znaků zadaného řetězce.
Příklady
Následující příklad vrací délku specifického řetězce:
Následující příklad vrací délku každé hodnoty v poli CustomerName:
Tato funkce vrací řetězec vzniklý složením zadaných řetězců.
Syntaxe
Parametr
zdroj1, ..., zdrojN
Hodnota typu String. Řetězce, které mají být složeny.
Vrací
Hodnota typu String. Řetězec vzniklý složením posloupnosti řetězců.
Příklad
Následující příklad vrací úplnou adresu spojením hodnot více polí:
BirtStr.concat( row["AddressLine1"], ", ", row["AddressLine2"], ", ", row["City"], " ", row["PostalCode"], "row["State"], ", ", row["Country"] )
Tato funkce vrací položku specifického podřetězce v daném řetězci.
Syntaxe
Parametry
cíl
Hodnota typu String. Podřetězec, který má být vyhledán. Hledání rozlišuje malá a velká písmena.
zdroj
Hodnota typu String. Řetězec, ve kterém má být vyhledán zadaný podřetězec.
start
Hodnota typu Integer. Volitelné. Poloha ve zdrojovém řetězci, na které se má hledání zahájit. Pokud vynecháte tento argument, funkce zahájí hledání u prvního znaku řetězce.
Vrací
Hodnota typu Integer. Číselná poloha podřetězce v řetězci. První znak řetězce začíná na poloze 0. Není-li podřetězec nalezen, funkce vrací hodnotu -1.
Příklady
Následující příklad vrací číselnou polohu zadaných znaků ve specifických řetězcích:
Následující příklad používá funkci BirtStr.indexOf( ) v kombinaci s funkcí BirtStr.left( ) pro zobrazení znaků, jež předcházejí znaku mezery ve jménu zákazníka. Funkce BirtStr.left( ) extrahuje podřetězec zadané délky počínaje prvním znakem. V tomto příkladu se délka podřetězce, který má být zobrazen, rovná číselné poloze znaku mezery.
Je-li jméno zákazníka Julie Murphy, výraz vrátí Julie.
Tato funkce extrahuje podřetězec zadané délky z řetězce počínaje znakem nejvíce vlevo, tj. prvním znakem.
Syntaxe
Parametry
zdroj
Hodnota typu String. Řetězec, ze kterého má být extrahován podřetězec.
n
Hodnota typu Integer. Počet znaků, které mají být extrahovány, počínaje prvním znakem.
Vrací
Hodnota typu Sring. Podřetězec specifické délky.
Příklady
Následující příklad vrací podřetězce různých délek specifických řetězců:
Následující příklad používá funkci BirtStr.indexOf( ) v kombinaci s funkcí BirtStr.left( ) pro zobrazení znaků, jež předcházejí znaku mezery ve jménu zákazníka. Funkce BirtStr.left( ) extrahuje podřetězec zadané délky počínaje prvním znakem. V tomto příkladu se délka podřetězce, který má být zobrazen, rovná číselné poloze znaku mezery.
Je-li jméno zákazníka Julie Murphy, výraz vrátí Julie.
Tato funkce extrahuje podřetězec zadané délky z řetězce počínaje znakem nejvíce vpravo, tj. posledním znakem.
Syntaxe
Parametry
zdroj
Hodnota typu String. Řetězec, ze kterého má být extrahován podřetězec.
n
Hodnota typu Integer. Počet znaků, které mají být extrahovány, počínaje posledním znakem.
Vrací
Hodnota typu String. Podřetězec specifické délky.
Příklady
Následující příklad vrací podřetězce různých délek specifických řetězců:
Následující příklad používá funkci BirtStr.right( ) v kombinaci s funkcemi BirtStr.indexOf( ) a BirtStr.charLength( ) k zobrazení znaků, které se vyskytují po znaku mezery ve jménu zákazníka. Tento příklad předpokládá, že počet znaků po pomlčce není stejný. Proto se délka celého řetězce (vracená funkcí BirtStr.charLength( )) minus délka k pomlčce (vracená funkcí BirtStr.indexOf( )) rovná počtu znaků k zobrazení.
Je-li jméno zákazníka Julie Murphy, výraz vrátí Murphy. Je-li jméno zákazníka Kwai Li, výraz vrátí řetězec Li.
Tato funkce vrací polohu specifického podřetězce v daném řetězci. Podřetězec může obsahovat zástupné znaky.
Syntaxe
Parametry
vzorek
Hodnota typu String. Vzorek řetězce, který má být vyhledán. Hledání nerozlišuje velká a malá písmena. Ve vzorku můžete použít následující zástupné znaky:
Pro shodu se znakem hvězdičky či otazníku v řetězci zadejte před tyto znaky dvě zpětná lomítka (\\). Chcete-li například hledat podřetězec R*10, použijte tento vzor:
zdroj
Hodnota typu String. Řetězec, ve kterém má být vyhledán zadaný podřetězec.
index
Hodnota typu Integer. Volitelné. Poloha ve zdrojovém řetězci, na které se má hledání zahájit. Pokud vynecháte tento argument, funkce zahájí hledání u prvního znaku řetězce.
Vrací
Hodnota typu Integer. Číselná poloha podřetězce v řetězci. První znak řetězce začíná na poloze 0. Není-li podřetězec nalezen, funkce vrací hodnotu -1.
Příklady
Následující příklad vrací číselnou polohu zadaných řetězcových vzorů ve specifickém řetězci:
Následující příklad hledá řetězcový vzor S*A v každé hodnotě v poli ProductCode. Je-li kód produktu KBS5412A, výraz vrátí 2.
Následující příklad používá funkci BirtStr.search( ) v kombinaci s funkcí BirtStr.left( ) k zobrazení znaků, které předcházejí řetězcovému vzoru -Model* v názvu produktu. Funkce BirtStr.left( ) extrahuje podřetězec zadané délky počínaje prvním znakem. V tomto příkladu se délka podřetězce, který má být zobrazen, rovná číselné poloze řetězcového vzoru.
Je-li název produktu XMS-ModelA-1234, výraz vrátí XMS.
Tato funkce převádí všechna písmena v řetězci na malá písmena.
Syntaxe
Parametr
zdroj
Hodnota typu String. Řetězec k převedení na malá písmena.
Vrací
Hodnota typu String. Zadaný řetězec převedený na malá písmena
Příklad
Následující příklad zobrazuje všechny hodnoty v poli productLine malými písmeny:
Tato funkce převádí všechna písmena v řetězci na velká písmena.
Syntaxe
Parametr
zdroj
Hodnota typu String. Řetězec k převedení na velká písmena.
Vrací
Hodnota typu String. Zadaný řetězec převedený na velká písmena
Příklad
Následující příklad zobrazuje všechny hodnoty v poli customerName velkými písmeny:
Tato funkce vrací řetězec bez všech úvodních a koncových mezer. Neodebírejte mezery mezi slovy.
Syntaxe
Parametr
zdroj
Hodnota typu String. Řetězec, z něhož mají být odebrány úvodní a koncové mezery.
Vrací
Hodnota typu String. Řetězec bez úvodních a koncových mezer.
Příklad
Následující příklad používá funkci BirtStr.trim( ) k odebrání všech úvodních a koncových mezer z hodnot v datových polích FirstName a LastName.
Tato funkce vrací řetězec bez všech úvodních a koncových mezer. Neodebírejte mezery mezi slovy.
Syntaxe
Parametr
zdroj
Hodnota typu String. Řetězec, ze kterého mají být odebrány úvodní mezery.
Vrací
Hodnota typu String. Řetězec bez úvodních mezer.
Příklad
Následující příklad skládá literálový řetězec s každou hodnotou v poli customerName. BirtStr.trimLeft( ) odebírá všechny mezery předcházející hodnotu customerName, takže mezi literálovým řetězcem a hodnotou customerName nebudou žádné další mezery.
Tato funkce vrací řetězec bez koncových mezer. Neodebírejte mezery mezi slovy.
Syntaxe
Parametr
zdroj
Hodnota typu String. Řetězec, ze kterého mají být odebrány koncové mezery.
Vrací
Hodnota typu String. Řetězec bez koncových mezer.
Příklad
Následující příklad skládá každou hodnotu v poli Comment se středníkem následovaným hodnotou pole Action. Funkce BirtStr.trimRight( ) odebírá všechny mezery následující hodnotu Comment, takže mezi řetězcem z pole Comment a středníkem nebudou žádné mezery.