Předchozí Další

Třída BirtStr

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.

BirtStr.charLength

Tato funkce vrací délku daného řetězce.

Syntaxe

integer BirtStr.charLength( string source )

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:

BirtStr.charLength( "Julie Murphy" ) // vrací 12

Následující příklad vrací délku každé hodnoty v poli CustomerName:

BirtStr.charLength( row["CustomerName"] )

BirtStr.concat

Tato funkce vrací řetězec vzniklý složením zadaných řetězců.

Syntaxe

string BirtStr.concat( string source1, ..., sourceN )

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"] )

BirtStr.indexOf

Tato funkce vrací položku specifického podřetězce v daném řetězci.

Syntaxe

integer BirtStr.indexOf( sring target, string source, integer start )

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:

BirtStr.indexOf( " ", "Julie Murphy" ) // vrací 5
BirtStr.indexOf( "-", "ModelA-1234-567" ) // vrací 6
BirtStr.indexOf( "-", "ModelA-1234-567", 7 ) // vrací 11

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.

spaceCharPosition = BirtStr.indexOf( " ", row["customerName"] );
displayFirstName = BirtStr.left( row["customerName"], spaceCharPosition );

Je-li jméno zákazníka Julie Murphy, výraz vrátí Julie.

BirtStr.left

Tato funkce extrahuje podřetězec zadané délky z řetězce počínaje znakem nejvíce vlevo, tj. prvním znakem.

Syntaxe

string BirtStr.left( string source, integer n )

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ů:

BirtStr.left( "Julie Murphy", 5 ) // vrací Julie
BirtStr.left( "Julie Murphy", 12 ) // vrací Julie Murphy

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.

spaceCharPosition = BirtStr.indexOf( " ", row["customerName"] );
displayFirstName = BirtStr.left( row["customerName"], spaceCharPosition );

Je-li jméno zákazníka Julie Murphy, výraz vrátí Julie.

BirtStr.right

Tato funkce extrahuje podřetězec zadané délky z řetězce počínaje znakem nejvíce vpravo, tj. posledním znakem.

Syntaxe

String BirtStr.right( String source, integer n )

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ů:

BirtStr.right( "Julie Murphy", 6 ) // vrací Murphy
BirtStr.right( "Julie Murphy", 12 ) // vrací Julie Murphy

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í.

spaceCharPosition = BirtStr.indexOf( " ", row["customerName"] );
displayLastName = BirtStr.right( row["customerName"], (BirtStr.charLength( row["customerName"] - (spaceCharPosition + 1)) )

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.

BirtStr.search

Tato funkce vrací polohu specifického podřetězce v daném řetězci. Podřetězec může obsahovat zástupné znaky.

Syntaxe

integer BirtStr.search( string pattern, string source, integer index )

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:

*
Hvězdička ( * ) odpovídá žádnému nebo více znakům včetně mezer. Například t*n odpovídá řetězcům tn, tin a teen.
*

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:

"R\\*10"

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:

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

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.

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

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.

stringPatternPosition = BirtStr.search( "-Model*", row["productName"] );
displayString = BirtStr.left( row["productName"], stringPatternPosition );

Je-li název produktu XMS-ModelA-1234, výraz vrátí XMS.

BirtStr.toLower

Tato funkce převádí všechna písmena v řetězci na malá písmena.

Syntaxe

string BirtStr.toLower( string source )

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:

BirtStr.toLower( row["productLine"] )

BirtStr.toUpper

Tato funkce převádí všechna písmena v řetězci na velká písmena.

Syntaxe

string BirtStr.toUpper( string source )

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:

BirtStr.toUpper( row["customerName"] )

BirtStr.trim

Tato funkce vrací řetězec bez všech úvodních a koncových mezer. Neodebírejte mezery mezi slovy.

Syntaxe

string BirtStr.trim( string source )

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.

BirtStr.trim( row["FirstName"]) + " " + BirtStr.trim(row["LastName"] )

BirtStr.trimLeft

Tato funkce vrací řetězec bez všech úvodních a koncových mezer. Neodebírejte mezery mezi slovy.

Syntaxe

string BirtStr.trimLeft( string source )

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.

"Jméno zákazníka: " + BirtStr.trimLeft( row["customerName"] )

BirtStr.trimRight

Tato funkce vrací řetězec bez koncových mezer. Neodebírejte mezery mezi slovy.

Syntaxe

string BirtStr.trimRight( string source )

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.

BirtStr.trimRight( row["Comment"]) + "; " + row["Action"] )

(c) Copyright Actuate Corporation 2013