Előző Következő

BirtStr osztály

A BirtStr osztály karaktersorozatok kezeléséhez biztosít függvényeket, például karaktersorozatok összefűzéséhez, felesleges üres helyek levágásához, egy karaktersorozat részeinek lekérdezéséhez és karaktersorozatok kis- és nagybetűs megjelenítéséhez. Ez az osztály statikus. Az alkalmazás nem hozhat létre példányokat az osztályból.

BirtStr.charLength

Ez a függvény egy adott karaktersorozat hosszát adja vissza.

Szintaxis

integer BirtStr.charLength( string source )

Paraméter

source

Karaktersorozat. A kiértékelendő karaktersorozat.

Visszatérési érték

Egész szám. A megadott karaktersorozatban lévő karakterek száma.

Példák

A következő példa egy adott karaktersorozat hosszát adja vissza:

BirtStr.charLength( "Julie Murphy" ) // visszaadott érték: 12

A következő példa a CustomerName (vásárlónév) mező egyes értékeinek hosszát adja vissza:

BirtStr.charLength( row["CustomerName"] )

BirtStr.concat

Ez a függvény a megadott karaktersorozatok összefűzésével létrejött karaktersorozatot adja vissza.

Szintaxis

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

Paraméter

source1, ..., sourceN

Karaktersorozat. Az összefűzendő karaktersorozatok.

Visszatérési érték

Karaktersorozat. A karaktersorozatok összefűzésének eredményeként létrejött karaktersorozat.

Példa

A következő példa egy teljes címet ad vissza több mező értékének összefűzésével:

BirtStr.concat( row["AddressLine1"], ", ", row["AddressLine2"], ", ", row["City"], " ", row["PostalCode"], "row["State"], ", ", row["Country"] )

BirtStr.indexOf

Ez a függvény egy megadott rész-karaktersorozat pozícióját adja vissza egy adott karaktersorozatban.

Szintaxis

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

Paraméterek

cél

Karaktersorozat. A keresendő rész-karaktersorozat. A keresésben a kis- és nagybetűk különbözőnek számítanak.

source

Karaktersorozat. A karaktersorozat, amelyben a megadott rész-karaktersorozatot keresni kell.

start

Egész szám. Elhagyható. A forrás karaktersorozat azon helye, ahol a keresést kezdeni kell. Ha kihagyja ezt az argumentumot, akkor a függvény a karaktersorozat első karakterétől kezdi a keresést.

Visszatérési érték

Egész szám. A rész-karaktersorozat numerikus pozíciója a karaktersorozatban. Egy karaktersorozat első karakterének pozíciója 0. Ha a rész-karaktersorozat nem található, akkor a függvény a -1 értéket adja vissza.

Példák

A következő példa a megadott karakterek numerikus pozícióját adja vissza a megadott karaktersorozatokban:

BirtStr.indexOf( " ", "Julie Murphy" ) // visszaadott érték: 5
BirtStr.indexOf( "-", "ModelA-1234-567" ) // visszaadott érték: 6
BirtStr.indexOf( "-", "ModelA-1234-567", 7 ) // visszaadott érték: 11

A következő példa a BirtStr.indexOf( ) függvényt a BirtStr.left( ) függvénnyel együtt használja a vásárlónévben (customerName) a szóköz karaktert megelőző karakterek megjelenítéséhez. A BirtStr.left( ) függvény kinyer egy megadott hosszúságú rész-karaktersorozatot az első karaktertől kezdve. A példában a megjelenítendő rész-karaktersorozat hossza megegyezik a szóköz karakter numerikus pozíciójával.

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

Ha a vásárló neve Julie Murphy, akkor a kifejezés a Julie értéket adja vissza.

BirtStr.left

Ez a függvény kinyer egy megadott hosszúságú rész-karaktersorozatot egy karaktersorozatból, a bal oldali, vagy első karaktertől kezdve.

Szintaxis

string BirtStr.left( string source, integer n )

Paraméterek

source

Karaktersorozat. A karaktersorozat, amelyből ki kell nyerni a rész-karaktersorozatot.

n

Egész szám. A kinyerni kívánt karakterek száma, az első karaktertől kezdve.

Visszatérési érték

Karaktersorozat. Egy megadott hosszúságú rész-karaktersorozat.

*
*
*

Példák

A következő példa különböző hosszúságú rész-karaktersorozatokat ad vissza a megadott karaktersorozatokból:

BirtStr.left( "Julie Murphy", 5 ) // visszaadott érték: Julie
BirtStr.left( "Julie Murphy", 12 ) // visszaadott érték: Julie Murphy

A következő példa a BirtStr.indexOf( ) függvényt a BirtStr.left( ) függvénnyel együtt használja a vásárlónévben (customerName) a szóköz karaktert megelőző karakterek megjelenítéséhez. A BirtStr.left( ) függvény kinyer egy megadott hosszúságú rész-karaktersorozatot az első karaktertől kezdve. A példában a megjelenítendő rész-karaktersorozat hossza megegyezik a szóköz karakter numerikus pozíciójával.

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

Ha a vásárló neve Julie Murphy, akkor a kifejezés a Julie értéket adja vissza.

BirtStr.right

Ez a függvény kinyer egy megadott hosszúságú rész-karaktersorozatot egy karaktersorozatból, a jobb oldali, vagy utolsó karaktertől kezdve.

Szintaxis

String BirtStr.right( String source, integer n )

Paraméterek

source

Karaktersorozat. A karaktersorozat, amelyből ki kell nyerni a rész-karaktersorozatot.

n

Egész szám. A kinyerni kívánt karakterek száma, az utolsó karaktertől kezdve.

Visszatérési érték

Karaktersorozat. Egy megadott hosszúságú rész-karaktersorozat.

*
*
*

Példák

A következő példa különböző hosszúságú rész-karaktersorozatokat ad vissza a megadott karaktersorozatokból:

BirtStr.right( "Julie Murphy", 6 ) // visszaadott érték: Murphy
BirtStr.right( "Julie Murphy", 12 ) // visszaadott érték: Julie Murphy

A következő példa a BirtStr.right( ) függvényt a BirtStr.indexOf( ) és BirtStr.charLength( ) függvényekkel együtt használja egy vásárlónévben a szóköz karakter után megjelenő karakterek megjelenítéséhez. Ez a példa feltételezi, hogy a kötőjel utáni karakterek száma változó. Ezért a megjelenítendő karakterek száma a teljes karaktersorozat hossza (amelyet a BirtStr.charLength( ) adott vissza) mínusz a kötőjelig terjedő hossz (amelyet a BirtStr.indexOf( ) függvény adott vissza).

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

Ha a vásárló neve Julie Murphy, akkor a kifejezés a Murphy értéket adja vissza. Ha a vásárló neve Kwai Li, akkor a kifejezés a Li értéket adja vissza.

BirtStr.search

Ez a függvény egy megadott rész-karaktersorozat pozícióját adja vissza egy adott karaktersorozatban. A rész-karaktersorozat tartalmazhat helyettesítő karaktereket.

Szintaxis

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

Paraméterek

minta

Karaktersorozat. A keresni kívánt karaktersorozat minta. A keresésben a kis- és nagybetűk nincsenek megkülönböztetve. A mintában a következő helyettesítő karaktereket használhatja:

*
A csillag ( * ) nulla vagy több karakternek felel meg, beleértve a szóközöket is. Például a t*n minta megfelel a tn, tin és teen karaktersorozatoknak.
*

Egy karaktersorozatban literálként szereplő csillag vagy kérdőjel kereséséhez szúrjon be a karakterek elé két fordított törtvonalat (\\). Például az R*10 rész-karaktersorozat kereséséhez használja a következő karaktersorozat mintát:

"R\\*10"

source

Karaktersorozat. A karaktersorozat, amelyben a megadott rész-karaktersorozatot keresni kell.

index

Egész szám. Elhagyható. A forrás karaktersorozat azon helye, ahol a keresést kezdeni kell. Ha kihagyja ezt az argumentumot, akkor a függvény a karaktersorozat első karakterétől kezdi a keresést.

Visszatérési érték

Egész szám. A rész-karaktersorozat numerikus pozíciója a karaktersorozatban. Egy karaktersorozat első karakterének pozíciója 0. Ha a rész-karaktersorozat nem található, akkor a függvény a -1 értéket adja vissza.

Példák

A következő példa a megadott karaktersorozat minták numerikus pozícióját adja vissza a megadott karaktersorozatokban:

BirtStr.search( "XM?", "XMS-ModelA-1234-567" ) // 0 értéket ad vissza
BirtStr.search( "ModelA*", "XMS-ModelA-1234-567" ) // 4 értéket ad vissza
BirtStr.search( "-", "XMS-ModelA-1234-567", 4 ) // 10 értéket ad vissza

A következő példa az S*A karaktersorozat mintát keresi meg a ProductCode (termékkód) mező minden egyes értékében. Ha a termékkód KBS5412A, akkor a kifejezés a 2 értéket adja vissza.

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

A következő példa a BirtStr.search( ) függvényt a BirtStr.left( ) függvénnyel együtt használja a -Model* karaktersorozat mintát megelőző karakterek megkereséséhez egy terméknévben. A BirtStr.left( ) függvény kinyer egy megadott hosszúságú rész-karaktersorozatot az első karaktertől kezdve. A példában a megjelenítendő rész-karaktersorozat hossza megegyezik a karaktersorozat minta numerikus pozíciójával.

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

Ha a termék neve XMS-ModelA-1234, akkor a kifejezés az XMS értéket adja vissza.

BirtStr.toLower

Ez a függvény kisbetűssé alakítja át egy karaktersorozat összes betűjét.

Szintaxis

string BirtStr.toLower( string source )

Paraméter

source

Karaktersorozat. A kisbetűssé alakítandó karaktersorozat.

Visszatérési érték

Karaktersorozat. A megadott karaktersorozat csupa kisbetűvel.

Példa

A következő példa a productLine (termékcsalád) mezőben lévő összes értéket kisbetűsen jeleníti meg:

BirtStr.toLower( row["productLine"] )

BirtStr.toUpper

Ez a függvény nagybetűssé alakítja át egy karaktersorozat összes betűjét.

Szintaxis

string BirtStr.toUpper( string source )

Paraméter

source

Karaktersorozat. A nagybetűssé alakítandó karaktersorozat.

Visszatérési érték

Karaktersorozat. A megadott karaktersorozat csupa nagybetűvel.

Példa

A következő példa a customerName (vásárlónév) mezőben lévő összes értéket nagybetűsen jeleníti meg:

BirtStr.toUpper( row["customerName"] )

BirtStr.trim

Ez a függvény egy olyan karaktersorozatot ad vissza, amelyből el van távolítva az összes bevezető és lezáró szóközszerű karakter. A szavak közti üres karaktereket nem távolítja el.

Szintaxis

string BirtStr.trim( string source )

Paraméter

source

Karaktersorozat. A karaktersorozat, amelyből el kell távolítani a bevezető és befejező üres karaktereket.

Visszatérési érték

Karaktersorozat. Egy karaktersorozat, amelyből el van távolítva az összes bevezető és befejező üres karakter.

Példa

A következő példa a BirtStr.trim( ) függvényt használja az összes bevezető és befejező üres karakter eltávolításához a FirstName (keresztnév) és LastName (vezetéknév) mezők értékeiből.

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

BirtStr.trimLeft

Ez a függvény egy olyan karaktersorozatot ad vissza, amelyből el van távolítva az összes bevezető és lezáró szóközszerű karakter. A szavak közti üres karaktereket nem távolítja el.

Szintaxis

string BirtStr.trimLeft( string source )

Paraméter

source

Karaktersorozat. A karaktersorozat, amelyből el kell távolítani a bevezető üres karaktereket.

Visszatérési érték

Karaktersorozat. Egy karaktersorozat, amelyből el van távolítva az összes bevezető üres karakter.

Példa

A következő példa összefűz egy literál karaktersorozatot a customerName (vásárlónév) mező minden egyes értékével. A BirtStr.trimLeft( ) függvény eltávolítja a customerName értéket megelőző összes üres karaktert, hogy a literál karaktersorozat és a customerName értéke között ne legyenek üres karakterek.

"Customer name: " + BirtStr.trimLeft( row["customerName"] )

BirtStr.trimRight

Ez a függvény egy olyan karaktersorozatot ad vissza, amelyből az összes befejező üres karakter el van távolítva. A szavak közti üres karaktereket nem távolítja el.

Szintaxis

string BirtStr.trimRight( string source )

Paraméter

source

Karaktersorozat. A karaktersorozat, amelyből el kell távolítani a befejező üres karaktereket.

Visszatérési érték

Karaktersorozat. Egy karaktersorozat, amelyből el van távolítva az összes befejező üres karakter.

Példa

A következő példa a Comment (megjegyzés) mezőben lévő minden egyes értéket összefűzi egy pontosvesszővel, majd az Action (művelet) mező egy elemével. A BirtStr.trimRight( ) függvény eltávolítja a Comment értéke utáni összes befejező üres karaktert, hogy a Comment karaktersorozat és a pontosvessző között ne legyenek üres karakterek.

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

(c) Copyright Actuate Corporation 2013